Agent Creator

创建新 OpenClaw Agent 的完整 checklist。

创建步骤

1. 创建工作区目录

mkdir -p ~/.openclaw/workspace-{agentId}/agent
mkdir -p ~/.openclaw/agents/{agentId}/agent

2. 必需的基础文件

在 ~/.openclaw/workspace-{agentId}/ 下创建：

⚠️ 常见遗漏：AGENTS.md 和 MEMORY.md 容易被漏掉，必须从 templates 复制。

3. Agent 配置目录

在 ~/.openclaw/workspace-{agentId}/agent/ 下创建：

4. 更新 openclaw.json

修改 ~/.openclaw/openclaw.json：

1. agents.list — 添加新 agent：

{
  "id": "{agentId}",
  "workspace": "/home/axelhu/.openclaw/workspace-{agentId}",
  "model": {
    "primary": "{provider}/{modelId}",
    "fallbacks": []
  }
}

1. agentToAgent.allow — 添加 agentId 到列表

1. 可选：bindings + channels — 如需飞书绑定：

{
  "agentId": "{agentId}",
  "match": {
    "channel": "feishu",
    "accountId": "{accountId}"
  }
}

并在 channels.accounts 中添加对应配置

5. 验证

运行 openclaw status 确认新 agent 已加载。

完整示例

# 1. 创建目录
mkdir -p ~/.openclaw/workspace-{agentId}/agent

# 2. 复制模板文件（必须！）
cp ~/.openclaw/skills/agent-creator/templates/IDENTITY.md ~/.openclaw/workspace-{agentId}/
cp ~/.openclaw/skills/agent-creator/templates/SOUL.md ~/.openclaw/workspace-{agentId}/
cp ~/.openclaw/skills/agent-creator/templates/USER.md ~/.openclaw/workspace-{agentId}/
cp ~/.openclaw/skills/agent-creator/templates/AGENTS.md ~/.openclaw/workspace-{agentId}/
cp ~/.openclaw/skills/agent-creator/templates/MEMORY.md ~/.openclaw/workspace-{agentId}/

# 3. 创建 agent 配置
# 编辑 agent/models.json 和 agent/auth.json

# 4. 更新 openclaw.json
# 添加到 agents.list, agentToAgent.allow, bindings, channels

检查清单

创建完成后确认：

• [ ] IDENTITY.md 存在（从 templates 复制）
• [ ] SOUL.md 存在（从 templates 复制）
• [ ] USER.md 存在（从 templates 复制）
• [ ] AGENTS.md 存在（从 templates 复制）
• [ ] MEMORY.md 存在（从 templates 复制）
• [ ] agent/models.json 存在
• [ ] agent/auth.json 存在
• [ ] openclaw.json 中 agents.list 已更新
• [ ] openclaw.json 中 agentToAgent.allow 已更新
• [ ] ✅ 完成后询问用户：是否需要配置飞书绑定？

飞书绑定（可选）

如需配置飞书，需要以下信息：

需要用户提供

1. accountId: 飞书机器人账号 ID（如 longcat）
2. botName: 机器人名称（如 "测试龙猫"）
3. appId: 飞书应用 ID
4. appSecret: 飞书应用密钥

配置步骤

1. 在 openclaw.json 中添加 bindings：

{
  "agentId": "{agentId}",
  "match": {
    "channel": "feishu",
    "accountId": "{accountId}"
  }
}

1. 在 openclaw.json 中添加 channels 配置：

"{accountId}": {
  "appId": "{appId}",
  "appSecret": "{appSecret}",
  "botName": "{botName}"
}

完整示例

创建完成后，询问用户：

> "Agent 创建完成！是否需要配置飞书机器人绑定？如需要，请提供：accountId、botName、appId、appSecret"