{"skill":{"slug":"huamu668-openclaw-multiagent","displayName":"OpenClaw Multi-Agent System","summary":"Configure multi-agent TG group system with shared Workspace + MemOS memory. Use when user wants to set up multiple AI agents in a Telegram group, with specia...","description":"---\nname: openclaw-multiagent\ndescription: Configure multi-agent TG group system with shared Workspace + MemOS memory. Use when user wants to set up multiple AI agents in a Telegram group, with specialized roles and collaborative workspace.\ntriggers:\n  - \"多 Agent\"\n  - \"多 agent\"\n  - \"multi-agent\"\n  - \"multi agent\"\n  - \"TG 群组\"\n  - \"telegram group\"\n  - \"配置 Agent\"\n  - \"添加子 Agent\"\n  - \"协作 Agent\"\nversion: 1.0.0\n---\n\n# OpenClaw 多 Agent TG 群组系统配置指南\n\n## 架构说明\n\n### Workspace：共享模式\n\n所有 Agent 共享同一个 workspace（`.openclaw/workspace`）。\n\n- 主 Agent 的文件在 workspace 根目录（SOUL.md, AGENTS.md 等）\n- 每个子 Agent 的专属文件在 `workspace/agents/{agent_id}/` 子目录\n- 共享上下文在 `workspace/shared-context/` — 所有 Agent 都可读取\n- 协作通过文件完成：一个 Agent 写文件，另一个 Agent 读文件\n\n### 记忆：MemOS Cloud\n\n- MemOS Cloud 插件已安装并启用，挂载在 OpenClaw 实例级别\n- **所有 Agent 自动共享同一个记忆池**\n- 不需要创建 memory/ 目录或 YYYY-MM-DD.md 日志文件\n\n### 目录结构\n\n```\nworkspace/\n├── SOUL.md                    # 主 Agent 的灵魂\n├── IDENTITY.md                # 主 Agent 身份卡\n├── AGENTS.md                  # 主 Agent 行为规则\n├── USER.md                    # 用户信息（所有 Agent 共享读取）\n├── HEARTBEAT.md               # 主 Agent 心跳任务\n├── shared-context/            # 跨 Agent 共享层\n│   ├── FEEDBACK-LOG.md        # 通用反馈/修正记录\n│   └── SIGNALS.md             # 当前关注的趋势/信号\n└── agents/\n    ├── {agent_id}/            # 子 Agent 专属目录\n    │   ├── SOUL.md            # 子 Agent 灵魂\n    │   ├── IDENTITY.md        # 子 Agent 身份卡\n    │   └── AGENTS.md          # 子 Agent 行为规则\n    └── {另一个agent_id}/\n        └── ...\n```\n\n## 配置前准备\n\n需要用户提供：\n\n1. **TG 群组 ID**（负数，如 -1002345678901）\n2. **用户的 TG 用户 ID**（如 5701780765）\n3. **主 Bot Token**（已配置或新提供）\n4. **子 Agent 列表**（YAML 格式）\n\n## ⚠️ 手动前置操作（必须）\n\n### 1. BotFather 设置\n每个子 Bot → `/setprivacy` → **Disable**（否则 Bot 无法读取群消息）\n\n### 2. 拉 Bot 进群\n所有 Bot（主 + 子）必须先被添加到目标 TG 群组\n\n### 3. 获取 Bot Token\n每个子 Bot 需要从 @BotFather 获取独立的 Bot Token\n\n### 4. 获取群组 ID\n- 转发群消息给 [@raw_data_bot](https://t.me/raw_data_bot)\n- 或查看群组消息的 `chat.id` 字段\n\n## 执行步骤\n\n### Step 1：备份\n```bash\ncp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak.$(date +%Y%m%d%H%M%S)\n```\n\n### Step 2：创建目录结构\n```bash\n# 共享上下文目录\nmkdir -p ~/.openclaw/workspace/shared-context\n\n# 每个子 Agent 的专属目录\nmkdir -p ~/.openclaw/workspace/agents/{agent_id}\n\n# 每个子 Agent 的 OpenClaw 内部目录\nmkdir -p ~/.openclaw/agents/{agent_id}/agent\n```\n\n### Step 3：创建共享上下文文件\n写入 `shared-context/FEEDBACK-LOG.md` 和 `shared-context/SIGNALS.md`\n\n### Step 4-6：为每个子 Agent 创建\n- SOUL.md\n- IDENTITY.md\n- AGENTS.md\n\n### Step 7：修改 openclaw.json\n关键修改：\n1. **channels.telegram** → 改为 accounts 多账号模式\n2. **agents** → 添加子 Agent 配置\n3. **bindings** → 添加 agent 与 channel 的绑定\n4. **tools** → 确保 agentToAgent 和 sessions.visibility 配置\n\n### Step 8-11：验证、重启、验证上线、汇报\n\n## 配置示例\n\n### Telegram Accounts 配置\n```json\n\"telegram\": {\n  \"enabled\": true,\n  \"dmPolicy\": \"pairing\",\n  \"groupPolicy\": \"allowlist\",\n  \"streaming\": \"partial\",\n  \"accounts\": {\n    \"default\": {\n      \"botToken\": \"主BotToken\",\n      \"dmPolicy\": \"pairing\",\n      \"groupPolicy\": \"allowlist\",\n      \"streaming\": \"partial\",\n      \"groups\": {\n        \"-100xxxx\": { \"requireMention\": false }\n      },\n      \"groupAllowFrom\": [\"用户ID\"]\n    },\n    \"agent_id\": {\n      \"name\": \"Agent名称\",\n      \"enabled\": true,\n      \"botToken\": \"子BotToken\",\n      \"dmPolicy\": \"allowlist\",\n      \"allowFrom\": [\"用户ID\"],\n      \"groupPolicy\": \"allowlist\",\n      \"groupAllowFrom\": [\"用户ID\"],\n      \"streaming\": \"off\",\n      \"commands\": {\n        \"native\": false,\n        \"nativeSkills\": false\n      },\n      \"groups\": {\n        \"-100xxxx\": { \"requireMention\": true }\n      }\n    }\n  }\n}\n```\n\n### Agents 配置\n```json\n\"agents\": {\n  \"defaults\": {\n    \"workspace\": \"~/.openclaw/workspace\",\n    \"model\": { \"primary\": \"...\" }\n  },\n  \"list\": [\n    { \"id\": \"main\" },\n    {\n      \"id\": \"agent_id\",\n      \"name\": \"agent_id\",\n      \"workspace\": \"~/.openclaw/workspace\",\n      \"model\": \"...\"\n    }\n  ]\n}\n```\n\n### Bindings 配置\n```json\n\"bindings\": [\n  {\n    \"agentId\": \"agent_id\",\n    \"match\": {\n      \"channel\": \"telegram\",\n      \"accountId\": \"agent_id\"\n    }\n  }\n]\n```\n\n## 踩坑防护清单\n\n- [ ] 子 Bot 的 `/setprivacy` 必须设为 Disable\n- [ ] 子 Bot 的 commands.native 和 nativeSkills 必须为 false\n- [ ] 原顶层 botToken 必须删除，移入 accounts.default\n- [ ] JSON 修改后必须验证语法\n- [ ] 所有 Agent 的 workspace 指向同一个路径\n- [ ] 区分 workspace/agents/（工作文件）和 .openclaw/agents/（内部数据）\n- [ ] shared-context/ 文件遵循一写多读原则\n- [ ] MemOS 记忆已全局生效，不要创建 memory/ 目录\n\n## 参考\n\n- 完整指南: https://github.com/bozhouDev/openclaw_agent_create_prompt\n","topics":["Multiagent","Multi Agent","Telegram"],"tags":{"latest":"1.0.0","multiagent":"1.0.0","openclaw":"1.0.0","telegram":"1.0.0","workspace":"1.0.0"},"stats":{"comments":0,"downloads":631,"installsAllTime":24,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772797832636,"updatedAt":1778491751707},"latestVersion":{"version":"1.0.0","createdAt":1772797832636,"changelog":"Initial release: Multi-agent Telegram group system with shared workspace","license":null},"metadata":null,"owner":{"handle":"huamu668","userId":"s17e1xpgre78th3jf9p61ztyq5884zgm","displayName":"huamu668","image":"https://avatars.githubusercontent.com/u/202473531?v=4"},"moderation":null}