create-agent

version: 1.0.0
author: 大总管
description: 一键创建新的 OpenClaw agent，包含完整的身份定义、团队集成和配置

---

功能

• ✅ 创建 agent 目录结构
• ✅ 生成身份文件模板（IDENTITY.md/SOUL.md/AGENTS.md/USER.md）
• ✅ 自动更新 openclaw.json（agents.list + bindings）
• ✅ 自动更新 TEAM.md（团队架构）
• ✅ 支持多种预设角色（开发/测试/运维/写作/产品等）
• ✅ 支持自定义模型和 Channel 配置

---

安装

clawhub install create-agent

或手动安装：

git clone <repo> ~/.openclaw/workspace/skills/create-agent

---

使用方法

交互式模式（推荐）

python3 ~/.openclaw/workspace/skills/create-agent/scripts/create_agent.py
# 或
python3 ~/.openclaw/workspace/skills/create-agent/scripts/create_agent.py --interactive

按提示输入： 1. Agent ID（如 dev-fe） 2. Agent 名称（如 前端工程师） 3. 选择预设角色（8 个模板可选） 4. 选择模型（4 个常用模型） 5. 选择 Channel（telegram/飞书） 6. 选择 Emoji 7. 确认工作区路径 8. 预览或执行

命令行模式

openclaw skill create-agent 
  --id "dev-fe" 
  --name "前端工程师" 
  --role "frontend" 
  --model "openai-codex/gpt-5.3-codex" 
  --channel "feishu" 
  --emoji "💻"

创建写作 Agent（示例）

openclaw skill create-agent 
  --id "inkflow" 
  --name "写作与分享助手" 
  --role "writer" 
  --model "bailian/qwen3.5-plus" 
  --channel "telegram" 
  --emoji "🖋️" 
  --workspace "/root/.openclaw/workspace-writing"

---

参数说明

参数	必填	说明	默认值
--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

---

预设角色模板

开发团队角色

Role	说明	默认模型
dev-tl	技术负责人 + 产品设计	openai-codex/gpt-5.3-codex
dev-fs	全栈工程师	openai-codex/gpt-5.3-codex
dev-qa	测试工程师	openai-codex/gpt-5.3-codex
dev-ops	运维工程师	openai-codex/gpt-5.3-codex
dev-fe	前端工程师	openai-codex/gpt-5.3-codex
dev-be	后端工程师	openai-codex/gpt-5.3-codex

其他角色

Role	说明	默认模型
writer	写作与分享助手	bailian/qwen3.5-plus
analyst	数据分析师	bailian/qwen3.5-plus
researcher	研究员	bailian/qwen3.5-plus
custom	自定义角色	bailian/qwen3.5-plus

---

生成的文件

Agent 目录结构

~/.openclaw/agents/<id>/agent/
├── IDENTITY.md    # 身份定义
├── SOUL.md        # 角色定位和工作原则
├── AGENTS.md      # 工作流程（引用 TEAM.md）
├── USER.md        # 用户偏好
├── auth.json      # 认证信息（自动生成）
└── models.json    # 模型配置（自动生成）

工作区目录

~/.openclaw/workspace-<id>/
├── AGENTS.md      # 引用 TEAM.md
├── SOUL.md        # 同步自 agent 目录
├── USER.md        # 同步自 agent 目录
├── IDENTITY.md    # 同步自 agent 目录
├── memory/        # 记忆文件
└── .openclaw/     # 会话存储

---

自动配置

1. 更新 openclaw.json

自动添加：

{
  "agents": {
    "list": [
      {
        "id": "<id>",
        "name": "<name>",
        "workspace": "<workspace>",
        "agentDir": "~/.openclaw/agents/<id>/agent",
        "model": "<model>",
        "identity": {
          "name": "<name>",
          "theme": "<role>",
          "emoji": "<emoji>"
        }
      }
    ]
  },
  "bindings": [
    {
      "agentId": "<id>",
      "match": {
        "channel": "<channel>",
        "accountId": "<id>"
      }
    }
  ]
}

2. 更新 TEAM.md

自动添加新 agent 信息到团队架构文档。

3. 创建 Channel 账号

如需要，自动在 channels.<channel>.accounts 中添加账号配置。

---

示例输出

$ openclaw skill create-agent --id "dev-fe" --name "前端工程师" --role "dev-fe"

🔧 正在创建 agent: dev-fe

[1/6] 创建目录结构...
  ✓ ~/.openclaw/agents/dev-fe/agent/
  ✓ ~/.openclaw/workspace-dev-fe/

[2/6] 生成身份文件...
  ✓ IDENTITY.md
  ✓ SOUL.md
  ✓ AGENTS.md
  ✓ USER.md

[3/6] 更新 openclaw.json...
  ✓ 添加 agent 到 agents.list
  ✓ 添加 binding 规则
  ✓ 添加 telegram 账号配置

[4/6] 更新 TEAM.md...
  ✓ 添加 dev-fe 到团队架构

[5/6] 设置文件权限...
  ✓ 认证文件权限：600

[6/6] 验证配置...
  ✓ 配置语法检查通过

✅ Agent "dev-fe" 创建完成！

下一步：
1. 配置 Channel Token（如需要）
2. 重启 Gateway: openclaw gateway restart
3. 验证 agent: openclaw agents list --bindings

---

后续步骤

配置 Channel

根据选择的 Channel，配置相应的 Token：

Telegram:

# 在 BotFather 创建 bot，获取 token
# 编辑 openclaw.json:
channels.telegram.accounts.<id>.botToken = "<token>"

飞书:

# 在飞书开放平台创建应用
# 设置环境变量：
export DEV_FE_APP_ID="cli_xxx"
export DEV_FE_APP_SECRET="xxx"

重启 Gateway

openclaw gateway restart

验证

openclaw agents list --bindings
openclaw channels status

---

删除 Agent

openclaw skill delete-agent --id "dev-fe"

会： 1. 从 openclaw.json 移除配置 2. 从 TEAM.md 移除信息 3. 删除 agent 目录（可选备份） 4. 删除工作区目录（可选备份）

---

注意事项

安全

• 认证文件权限自动设置为 600
• Token 建议使用环境变量
• 敏感信息不要提交到版本控制

命名规范

• Agent ID：小写字母 + 数字 + 连字符（如 dev-fe）
• Agent 名称：中文或英文（如 前端工程师）
• 工作区：~/.openclaw/workspace-<id>

模型选择

场景	推荐模型
代码/配置操作	openai-codex/gpt-5.3-codex
复杂推理	anthropic/claude-sonnet-4-6
日常任务	bailian/qwen3.5-plus
长文本分析	bailian/kimi-k2.5

---

故障排查

问题：Gateway 启动失败

# 检查配置语法
openclaw doctor

# 查看详细日志
openclaw logs --follow

问题：Agent 不响应

# 检查路由配置
openclaw agents list --bindings

# 检查 Channel 状态
openclaw channels status

问题：TEAM.md 更新失败

手动编辑 /root/.openclaw/workspace/TEAM.md，添加新 agent 信息。

---

变更历史

版本	日期	变更
1.0.0	2026-02-28	初始版本

---

许可证

MIT License

---

来源： 基于 2026-02-28 创建 InkFlow agent 的实战经验总结