alabamajumia-del/openclaw-agent-manager

OpenClaw Agent Manager

自动化创建 OpenClaw Agent 并绑定到飞书群组。

核心功能

1. 创建 Agent 目录结构 - 自动创建 agent/ 和 sessions/ 目录
2. 生成 models.json - 配置 GLM-5 模型
3. 添加到 agents.list - 注册 Agent
4. 创建 binding - 绑定到飞书群组
5. 更新 groupAllowFrom - 添加入口白名单
6. 重启 Gateway - 应用配置
7. 验证配置 - 确保配置正确

使用方法

基本用法

python3 ~/.openclaw/skills/openclaw-agent-manager/scripts/create_agent.py <agent_id> <agent_name> <group_id> [model]

参数说明

| 参数 | 必填 | 说明 | |------|------|------| | agent_id | ✅ | Agent ID，只能用小写字母、数字、连字符 | | agent_name | ✅ | Agent 显示名称 | | group_id | ✅ | 飞书群组 ID（oc_xxx 格式）| | model | ❌ | 模型，默认 zai/glm-5 |

示例

# 创建最简单的 Agent
python3 create_agent.py my-agent 我的助手 oc_xxx

# 指定模型
python3 create_agent.py analyst-agent 分析助手 oc_yyy glm-5

执行流程

┌─────────────────────────────────────────────┐
│ 1. 备份配置                                  │
│    ~/.openclaw/backups/openclaw.json.backup │
├─────────────────────────────────────────────┤
│ 2. 创建目录结构                               │
│    agents/<agent_id>/{agent,sessions}/      │
├─────────────────────────────────────────────┤
│ 3. 生成 models.json                         │
│    配置 GLM-5 模型                          │
├─────────────────────────────────────────────┤
│ 4. 添加到 agents.list                       │
│    "id", "name", "agentDir", "model"       │
├─────────────────────────────────────────────┤
│ 5. 创建 binding                             │
│    agentId + match (feishu, peer.group)     │
├─────────────────────────────────────────────┤
│ 6. 更新 groupAllowFrom                     │
│    自动合并，不覆盖现有群组                   │
├─────────────────────────────────────────────┤
│ 7. 保存并验证                               │
│    openclaw doctor --fix                   │
├─────────────────────────────────────────────┤
│ 8. 重启 Gateway                            │
│    openclaw gateway restart                │
└─────────────────────────────────────────────┘

注意事项

⚠️ 关键教训（2026-03-23 更新）

1. 必须同时配置两层:

   • bindings - 路由配置
   • groupAllowFrom - 白名单

2. groupAllowFrom 要合并，不要覆盖:

   # ❌ 错误：直接赋值覆盖
   config["channels"]["feishu"]["groupAllowFrom"] = [new_group]
   
   # ✅ 正确：追加合并
   group_allow_from.append(new_group)
   

3. 群组必须使用 peer 字段，私聊使用 accountId:

   # ✅ 群组（正确）
   "match": {
       "channel": "feishu",
       "peer": {"kind": "group", "id": "oc_xxx"}
   }
   
   # ❌ 错误：群组使用 accountId
   "match": {"channel": "feishu", "accountId": "oc_xxx"}
   

验证命令

# 检查 bindings
openclaw config get bindings | grep <agent_id>

# 检查 groupAllowFrom
openclaw config get channels.feishu.groupAllowFrom

# 检查 Gateway 状态
openclaw gateway status

错误处理

脚本会在以下情况停止并提示：

• 参数缺失
• 配置保存失败
• Gateway 重启失败（警告，继续）

输出示例

============================================================
🚀 开始创建 Agent: my-agent
   名称: 我的助手
   群组: oc_xxx
   模型: glm-5
============================================================

✅ 配置已备份: .../openclaw.json.backup.20260322_232100
✅ Agent 目录已创建: .../agents/my-agent
✅ models.json 已创建
✅ Agent 'my-agent' 已添加到 agents.list
✅ Binding 已添加: my-agent -> oc_xxx
✅ groupAllowFrom 已更新，包含 8 个群组
✅ 配置已保存
✅ 配置验证通过
✅ Gateway 重启成功

============================================================
✅ Agent 创建完成!
============================================================