{
  "schemaVersion": "1.0",
  "item": {
    "slug": "create-openclaw-agent",
    "name": "Create Agent",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/mengwuzhi/create-openclaw-agent",
    "canonicalUrl": "https://clawhub.ai/mengwuzhi/create-openclaw-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/create-openclaw-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=create-openclaw-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "GET_TOKEN.md",
      "PUBLISH.md",
      "README.md",
      "SKILL.md",
      "scripts/create_agent.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/create-openclaw-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/create-openclaw-agent",
    "agentPageUrl": "https://openagent3.xyz/skills/create-openclaw-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/create-openclaw-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/create-openclaw-agent/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "create-agent",
        "body": "version: 1.0.0\nauthor: 大总管\ndescription: 一键创建新的 OpenClaw agent，包含完整的身份定义、团队集成和配置"
      },
      {
        "title": "功能",
        "body": "✅ 创建 agent 目录结构\n✅ 生成身份文件模板（IDENTITY.md/SOUL.md/AGENTS.md/USER.md）\n✅ 自动更新 openclaw.json（agents.list + bindings）\n✅ 自动更新 TEAM.md（团队架构）\n✅ 支持多种预设角色（开发/测试/运维/写作/产品等）\n✅ 支持自定义模型和 Channel 配置"
      },
      {
        "title": "安装",
        "body": "clawhub install create-agent\n\n或手动安装：\n\ngit clone <repo> ~/.openclaw/workspace/skills/create-agent"
      },
      {
        "title": "交互式模式（推荐）",
        "body": "python3 ~/.openclaw/workspace/skills/create-agent/scripts/create_agent.py\n# 或\npython3 ~/.openclaw/workspace/skills/create-agent/scripts/create_agent.py --interactive\n\n按提示输入：\n\nAgent ID（如 dev-fe）\nAgent 名称（如 前端工程师）\n选择预设角色（8 个模板可选）\n选择模型（4 个常用模型）\n选择 Channel（telegram/飞书）\n选择 Emoji\n确认工作区路径\n预览或执行"
      },
      {
        "title": "命令行模式",
        "body": "openclaw skill create-agent \\\n  --id \"dev-fe\" \\\n  --name \"前端工程师\" \\\n  --role \"frontend\" \\\n  --model \"openai-codex/gpt-5.3-codex\" \\\n  --channel \"feishu\" \\\n  --emoji \"💻\""
      },
      {
        "title": "创建写作 Agent（示例）",
        "body": "openclaw skill create-agent \\\n  --id \"inkflow\" \\\n  --name \"写作与分享助手\" \\\n  --role \"writer\" \\\n  --model \"bailian/qwen3.5-plus\" \\\n  --channel \"telegram\" \\\n  --emoji \"🖋️\" \\\n  --workspace \"/root/.openclaw/workspace-writing\""
      },
      {
        "title": "参数说明",
        "body": "参数必填说明默认值--id✅Agent ID（字母 + 数字 + 连字符）---name✅Agent 显示名称---role❌预设角色模板custom--model❌使用的模型bailian/qwen3.5-plus--channel❌通信渠道telegram--emoji❌Agent emoji🤖--workspace❌工作区路径/root/.openclaw/workspace-<id>--dry-run❌预览不执行false"
      },
      {
        "title": "开发团队角色",
        "body": "Role说明默认模型dev-tl技术负责人 + 产品设计openai-codex/gpt-5.3-codexdev-fs全栈工程师openai-codex/gpt-5.3-codexdev-qa测试工程师openai-codex/gpt-5.3-codexdev-ops运维工程师openai-codex/gpt-5.3-codexdev-fe前端工程师openai-codex/gpt-5.3-codexdev-be后端工程师openai-codex/gpt-5.3-codex"
      },
      {
        "title": "其他角色",
        "body": "Role说明默认模型writer写作与分享助手bailian/qwen3.5-plusanalyst数据分析师bailian/qwen3.5-plusresearcher研究员bailian/qwen3.5-pluscustom自定义角色bailian/qwen3.5-plus"
      },
      {
        "title": "Agent 目录结构",
        "body": "~/.openclaw/agents/<id>/agent/\n├── IDENTITY.md    # 身份定义\n├── SOUL.md        # 角色定位和工作原则\n├── AGENTS.md      # 工作流程（引用 TEAM.md）\n├── USER.md        # 用户偏好\n├── auth.json      # 认证信息（自动生成）\n└── models.json    # 模型配置（自动生成）"
      },
      {
        "title": "工作区目录",
        "body": "~/.openclaw/workspace-<id>/\n├── AGENTS.md      # 引用 TEAM.md\n├── SOUL.md        # 同步自 agent 目录\n├── USER.md        # 同步自 agent 目录\n├── IDENTITY.md    # 同步自 agent 目录\n├── memory/        # 记忆文件\n└── .openclaw/     # 会话存储"
      },
      {
        "title": "1. 更新 openclaw.json",
        "body": "自动添加：\n\n{\n  \"agents\": {\n    \"list\": [\n      {\n        \"id\": \"<id>\",\n        \"name\": \"<name>\",\n        \"workspace\": \"<workspace>\",\n        \"agentDir\": \"~/.openclaw/agents/<id>/agent\",\n        \"model\": \"<model>\",\n        \"identity\": {\n          \"name\": \"<name>\",\n          \"theme\": \"<role>\",\n          \"emoji\": \"<emoji>\"\n        }\n      }\n    ]\n  },\n  \"bindings\": [\n    {\n      \"agentId\": \"<id>\",\n      \"match\": {\n        \"channel\": \"<channel>\",\n        \"accountId\": \"<id>\"\n      }\n    }\n  ]\n}"
      },
      {
        "title": "2. 更新 TEAM.md",
        "body": "自动添加新 agent 信息到团队架构文档。"
      },
      {
        "title": "3. 创建 Channel 账号",
        "body": "如需要，自动在 channels.<channel>.accounts 中添加账号配置。"
      },
      {
        "title": "示例输出",
        "body": "$ openclaw skill create-agent --id \"dev-fe\" --name \"前端工程师\" --role \"dev-fe\"\n\n🔧 正在创建 agent: dev-fe\n\n[1/6] 创建目录结构...\n  ✓ ~/.openclaw/agents/dev-fe/agent/\n  ✓ ~/.openclaw/workspace-dev-fe/\n\n[2/6] 生成身份文件...\n  ✓ IDENTITY.md\n  ✓ SOUL.md\n  ✓ AGENTS.md\n  ✓ USER.md\n\n[3/6] 更新 openclaw.json...\n  ✓ 添加 agent 到 agents.list\n  ✓ 添加 binding 规则\n  ✓ 添加 telegram 账号配置\n\n[4/6] 更新 TEAM.md...\n  ✓ 添加 dev-fe 到团队架构\n\n[5/6] 设置文件权限...\n  ✓ 认证文件权限：600\n\n[6/6] 验证配置...\n  ✓ 配置语法检查通过\n\n✅ Agent \"dev-fe\" 创建完成！\n\n下一步：\n1. 配置 Channel Token（如需要）\n2. 重启 Gateway: openclaw gateway restart\n3. 验证 agent: openclaw agents list --bindings"
      },
      {
        "title": "配置 Channel",
        "body": "根据选择的 Channel，配置相应的 Token：\n\nTelegram:\n\n# 在 BotFather 创建 bot，获取 token\n# 编辑 openclaw.json:\nchannels.telegram.accounts.<id>.botToken = \"<token>\"\n\n飞书:\n\n# 在飞书开放平台创建应用\n# 设置环境变量：\nexport DEV_FE_APP_ID=\"cli_xxx\"\nexport DEV_FE_APP_SECRET=\"xxx\""
      },
      {
        "title": "重启 Gateway",
        "body": "openclaw gateway restart"
      },
      {
        "title": "验证",
        "body": "openclaw agents list --bindings\nopenclaw channels status"
      },
      {
        "title": "删除 Agent",
        "body": "openclaw skill delete-agent --id \"dev-fe\"\n\n会：\n\n从 openclaw.json 移除配置\n从 TEAM.md 移除信息\n删除 agent 目录（可选备份）\n删除工作区目录（可选备份）"
      },
      {
        "title": "安全",
        "body": "认证文件权限自动设置为 600\nToken 建议使用环境变量\n敏感信息不要提交到版本控制"
      },
      {
        "title": "命名规范",
        "body": "Agent ID：小写字母 + 数字 + 连字符（如 dev-fe）\nAgent 名称：中文或英文（如 前端工程师）\n工作区：~/.openclaw/workspace-<id>"
      },
      {
        "title": "模型选择",
        "body": "场景推荐模型代码/配置操作openai-codex/gpt-5.3-codex复杂推理anthropic/claude-sonnet-4-6日常任务bailian/qwen3.5-plus长文本分析bailian/kimi-k2.5"
      },
      {
        "title": "问题：Gateway 启动失败",
        "body": "# 检查配置语法\nopenclaw doctor\n\n# 查看详细日志\nopenclaw logs --follow"
      },
      {
        "title": "问题：Agent 不响应",
        "body": "# 检查路由配置\nopenclaw agents list --bindings\n\n# 检查 Channel 状态\nopenclaw channels status"
      },
      {
        "title": "问题：TEAM.md 更新失败",
        "body": "手动编辑 /root/.openclaw/workspace/TEAM.md，添加新 agent 信息。"
      },
      {
        "title": "变更历史",
        "body": "版本日期变更1.0.02026-02-28初始版本"
      },
      {
        "title": "许可证",
        "body": "MIT License\n\n来源： 基于 2026-02-28 创建 InkFlow agent 的实战经验总结"
      }
    ],
    "body": "create-agent\n\nversion: 1.0.0\nauthor: 大总管\ndescription: 一键创建新的 OpenClaw agent，包含完整的身份定义、团队集成和配置\n\n功能\n✅ 创建 agent 目录结构\n✅ 生成身份文件模板（IDENTITY.md/SOUL.md/AGENTS.md/USER.md）\n✅ 自动更新 openclaw.json（agents.list + bindings）\n✅ 自动更新 TEAM.md（团队架构）\n✅ 支持多种预设角色（开发/测试/运维/写作/产品等）\n✅ 支持自定义模型和 Channel 配置\n安装\nclawhub install create-agent\n\n\n或手动安装：\n\ngit clone <repo> ~/.openclaw/workspace/skills/create-agent\n\n使用方法\n交互式模式（推荐）\npython3 ~/.openclaw/workspace/skills/create-agent/scripts/create_agent.py\n# 或\npython3 ~/.openclaw/workspace/skills/create-agent/scripts/create_agent.py --interactive\n\n\n按提示输入：\n\nAgent ID（如 dev-fe）\nAgent 名称（如 前端工程师）\n选择预设角色（8 个模板可选）\n选择模型（4 个常用模型）\n选择 Channel（telegram/飞书）\n选择 Emoji\n确认工作区路径\n预览或执行\n命令行模式\nopenclaw skill create-agent \\\n  --id \"dev-fe\" \\\n  --name \"前端工程师\" \\\n  --role \"frontend\" \\\n  --model \"openai-codex/gpt-5.3-codex\" \\\n  --channel \"feishu\" \\\n  --emoji \"💻\"\n\n创建写作 Agent（示例）\nopenclaw skill create-agent \\\n  --id \"inkflow\" \\\n  --name \"写作与分享助手\" \\\n  --role \"writer\" \\\n  --model \"bailian/qwen3.5-plus\" \\\n  --channel \"telegram\" \\\n  --emoji \"🖋️\" \\\n  --workspace \"/root/.openclaw/workspace-writing\"\n\n参数说明\n参数\t必填\t说明\t默认值\n--id\t✅\tAgent ID（字母 + 数字 + 连字符）\t-\n--name\t✅\tAgent 显示名称\t-\n--role\t❌\t预设角色模板\tcustom\n--model\t❌\t使用的模型\tbailian/qwen3.5-plus\n--channel\t❌\t通信渠道\ttelegram\n--emoji\t❌\tAgent emoji\t🤖\n--workspace\t❌\t工作区路径\t/root/.openclaw/workspace-<id>\n--dry-run\t❌\t预览不执行\tfalse\n预设角色模板\n开发团队角色\nRole\t说明\t默认模型\ndev-tl\t技术负责人 + 产品设计\topenai-codex/gpt-5.3-codex\ndev-fs\t全栈工程师\topenai-codex/gpt-5.3-codex\ndev-qa\t测试工程师\topenai-codex/gpt-5.3-codex\ndev-ops\t运维工程师\topenai-codex/gpt-5.3-codex\ndev-fe\t前端工程师\topenai-codex/gpt-5.3-codex\ndev-be\t后端工程师\topenai-codex/gpt-5.3-codex\n其他角色\nRole\t说明\t默认模型\nwriter\t写作与分享助手\tbailian/qwen3.5-plus\nanalyst\t数据分析师\tbailian/qwen3.5-plus\nresearcher\t研究员\tbailian/qwen3.5-plus\ncustom\t自定义角色\tbailian/qwen3.5-plus\n生成的文件\nAgent 目录结构\n~/.openclaw/agents/<id>/agent/\n├── IDENTITY.md    # 身份定义\n├── SOUL.md        # 角色定位和工作原则\n├── AGENTS.md      # 工作流程（引用 TEAM.md）\n├── USER.md        # 用户偏好\n├── auth.json      # 认证信息（自动生成）\n└── models.json    # 模型配置（自动生成）\n\n工作区目录\n~/.openclaw/workspace-<id>/\n├── AGENTS.md      # 引用 TEAM.md\n├── SOUL.md        # 同步自 agent 目录\n├── USER.md        # 同步自 agent 目录\n├── IDENTITY.md    # 同步自 agent 目录\n├── memory/        # 记忆文件\n└── .openclaw/     # 会话存储\n\n自动配置\n1. 更新 openclaw.json\n\n自动添加：\n\n{\n  \"agents\": {\n    \"list\": [\n      {\n        \"id\": \"<id>\",\n        \"name\": \"<name>\",\n        \"workspace\": \"<workspace>\",\n        \"agentDir\": \"~/.openclaw/agents/<id>/agent\",\n        \"model\": \"<model>\",\n        \"identity\": {\n          \"name\": \"<name>\",\n          \"theme\": \"<role>\",\n          \"emoji\": \"<emoji>\"\n        }\n      }\n    ]\n  },\n  \"bindings\": [\n    {\n      \"agentId\": \"<id>\",\n      \"match\": {\n        \"channel\": \"<channel>\",\n        \"accountId\": \"<id>\"\n      }\n    }\n  ]\n}\n\n2. 更新 TEAM.md\n\n自动添加新 agent 信息到团队架构文档。\n\n3. 创建 Channel 账号\n\n如需要，自动在 channels.<channel>.accounts 中添加账号配置。\n\n示例输出\n$ openclaw skill create-agent --id \"dev-fe\" --name \"前端工程师\" --role \"dev-fe\"\n\n🔧 正在创建 agent: dev-fe\n\n[1/6] 创建目录结构...\n  ✓ ~/.openclaw/agents/dev-fe/agent/\n  ✓ ~/.openclaw/workspace-dev-fe/\n\n[2/6] 生成身份文件...\n  ✓ IDENTITY.md\n  ✓ SOUL.md\n  ✓ AGENTS.md\n  ✓ USER.md\n\n[3/6] 更新 openclaw.json...\n  ✓ 添加 agent 到 agents.list\n  ✓ 添加 binding 规则\n  ✓ 添加 telegram 账号配置\n\n[4/6] 更新 TEAM.md...\n  ✓ 添加 dev-fe 到团队架构\n\n[5/6] 设置文件权限...\n  ✓ 认证文件权限：600\n\n[6/6] 验证配置...\n  ✓ 配置语法检查通过\n\n✅ Agent \"dev-fe\" 创建完成！\n\n下一步：\n1. 配置 Channel Token（如需要）\n2. 重启 Gateway: openclaw gateway restart\n3. 验证 agent: openclaw agents list --bindings\n\n后续步骤\n配置 Channel\n\n根据选择的 Channel，配置相应的 Token：\n\nTelegram:\n\n# 在 BotFather 创建 bot，获取 token\n# 编辑 openclaw.json:\nchannels.telegram.accounts.<id>.botToken = \"<token>\"\n\n\n飞书:\n\n# 在飞书开放平台创建应用\n# 设置环境变量：\nexport DEV_FE_APP_ID=\"cli_xxx\"\nexport DEV_FE_APP_SECRET=\"xxx\"\n\n重启 Gateway\nopenclaw gateway restart\n\n验证\nopenclaw agents list --bindings\nopenclaw channels status\n\n删除 Agent\nopenclaw skill delete-agent --id \"dev-fe\"\n\n\n会：\n\n从 openclaw.json 移除配置\n从 TEAM.md 移除信息\n删除 agent 目录（可选备份）\n删除工作区目录（可选备份）\n注意事项\n安全\n认证文件权限自动设置为 600\nToken 建议使用环境变量\n敏感信息不要提交到版本控制\n命名规范\nAgent ID：小写字母 + 数字 + 连字符（如 dev-fe）\nAgent 名称：中文或英文（如 前端工程师）\n工作区：~/.openclaw/workspace-<id>\n模型选择\n场景\t推荐模型\n代码/配置操作\topenai-codex/gpt-5.3-codex\n复杂推理\tanthropic/claude-sonnet-4-6\n日常任务\tbailian/qwen3.5-plus\n长文本分析\tbailian/kimi-k2.5\n故障排查\n问题：Gateway 启动失败\n# 检查配置语法\nopenclaw doctor\n\n# 查看详细日志\nopenclaw logs --follow\n\n问题：Agent 不响应\n# 检查路由配置\nopenclaw agents list --bindings\n\n# 检查 Channel 状态\nopenclaw channels status\n\n问题：TEAM.md 更新失败\n\n手动编辑 /root/.openclaw/workspace/TEAM.md，添加新 agent 信息。\n\n变更历史\n版本\t日期\t变更\n1.0.0\t2026-02-28\t初始版本\n许可证\n\nMIT License\n\n来源： 基于 2026-02-28 创建 InkFlow agent 的实战经验总结"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/mengwuzhi/create-openclaw-agent",
    "publisherUrl": "https://clawhub.ai/mengwuzhi/create-openclaw-agent",
    "owner": "mengwuzhi",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/create-openclaw-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/create-openclaw-agent",
    "agentUrl": "https://openagent3.xyz/skills/create-openclaw-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/create-openclaw-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/create-openclaw-agent/agent.md"
  }
}