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"

参数说明

预设角色模板

开发团队角色

其他角色

生成的文件

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>

模型选择

故障排查

问题：Gateway 启动失败

# 检查配置语法
openclaw doctor

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

问题：Agent 不响应

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

# 检查 Channel 状态
openclaw channels status

问题：TEAM.md 更新失败

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

变更历史

许可证

MIT License

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