--- date: '2026-05-14 08:00:00' description: OpenClaw 多 Agent 架构将 OpenClaw 用作个人助理，支持笔记回顾、定时关注、信息获取与追踪等工作流，并通过 MCP 连接各工具。系统由主调度中书令（main）负责接收请求、意图识别、任务拆分与派工，四个子司（司记、司务、司情、司工）分别负责笔记管理、待办与日程、外部情报检索以及代码、配置与运维。每个司都有明确职责、提示词要点和工具使用规范，确保任务安全、可追溯并高效完成。 hidden: false urlname: openclaw-agents title: OpenClaw 多 Agent 架构 tags: - 赛博空间 - OpenClaw updated: '2026-07-01 06:56:00' draft: false --- ## 前言 我使用 OpenClaw 的场景相对比较窄，我会将其作为个人助手来使用，例如笔记回顾、定时关注领域获取与追踪、通过 MCP 连通各个工具。 我的日常流程： 1. 每天早上会有日报定时任务发到我的微信/飞书 2. 如果遇到感兴趣的新闻/话题，会继续让他深挖，了解更多的背景知识 3. 如果对我有帮助，我会让他总结到我的 Flomo 中去 4. 如果可能有TODO 任务，我会让他写到滴答清单中提醒我 其他场景也很类似，有时候从别的信息渠道获取到我感兴趣的话题，我也会通过这个工作流来解决。 不过现在，我把这套工作流拆分/替换成更细的领域了： - 项目开发领域则交给 Codex 去完成，也是配置 MCP 和编写 Skill 来实现 - 原本这套逻辑改造成 Hermes 适配的版本了，最近也正在体验 现有的这套架构依旧在OpenClaw运行，只不过很少用了。更多时候我都是用来测试 OpenClaw 的 BUG，看下有什么我能贡献的 PR 了。 但是这份多 Agent 架构的完整配置依然可以记录一下。 ## 架构总览 ```javascript 用户（飞书/主对话） │ ▼ ┌─────────────────┐ │ 中书令 main │ ← 默认入口，总调度 │ /workspace/ │ 路由 → 验收 → 交付 └────────┬────────┘ │ sessions_spawn / sessions_send ▼ ┌────┼────┬──────┐ ▼ ▼ ▼ ▼ 司记 司务 司情 司工 siji siwu siqing sigong ``` ## 目录结构 ```javascript .openclaw/ ├── openclaw.json ← 主配置文件（所有 agent + channel + MCP 配置） ├── workspace/ ← main 中书令 workspace（提示词主目录） │ └── AGENTS.md / SOUL.md / IDENTITY.md / USER.md / TOOLS.md │ ├── workspace-siji/ ← 司记 workspace │ └── AGENTS.md / SOUL.md / IDENTITY.md / USER.md / TOOLS.md │ ├── workspace-siwu/ ← 司务 workspace │ └── AGENTS.md / SOUL.md / IDENTITY.md / USER.md / TOOLS.md │ ├── workspace-siqing/ ← 司情 workspace │ └── AGENTS.md / SOUL.md / IDENTITY.md / USER.md / TOOLS.md │ └── workspace-sigong/ ← 司工 workspace └── AGENTS.md / SOUL.md / IDENTITY.md / USER.md / TOOLS.md ``` ## 关键配置（openclaw.json） ```javascript { "agents": { "defaults": { "model": { "primary": "volcengine-plan/ark-code-latest" }, "userTimezone": "Asia/Shanghai", "compaction": { "mode": "safeguard" }, "memorySearch": { "provider": "openai", "model": "doubao-embedding-vision" } }, "list": [ { "id": "main", "subagents": { "allowAgents": ["siji","siwu","siqing","sigong","review"], "requireAgentId": true }}, { "id": "sigong", "workspace": ".openclaw/workspace-sigong", "agentDir": "/home/node/.openclaw/agents/sigong/agent" }, { "id": "siji", "workspace": ".openclaw/workspace-siji", "agentDir": "/home/node/.openclaw/agents/siji/agent", "tools": { "alsoAllow": ["mcp:flomo:*"] }}, { "id": "siqing", "workspace": ".openclaw/workspace-siqing", "agentDir": "/home/node/.openclaw/agents/siqing/agent" }, { "id": "siwu", "workspace": ".openclaw/workspace-siwu", "agentDir": "/home/node/.openclaw/agents/siwu/agent", "tools": { "alsoAllow": ["mcp:dida365:*"] }} ] } "mcp": { "servers": { "flomo": { "transport": "streamable-http", "url": "https://flomoapp.com/mcp", "headers": { "Authorization": "Bearer xxx" } }, "dida365": { "url": "https://mcp.dida365.com", "headers": { "Authorization": "Bearer xxx" } } } } } ``` ## Agent 职责分工 ### 中书令（总调度入口） 唯一默认用户交互入口，所有用户请求先到达此处 核心职责： 1. 接收用户请求，识别真实意图 2. 判断任务类型，匹配对应执行司 3. 拆分复合多意图请求为独立子任务分别派工 4. 必要时提交门下省复核结果 5. 汇总所有子任务结果，统一整理后回复用户 核心原则：优先调度派工而非亲自处理所有细节，已有专职司的任务必须派工 ### 各司分工 - 司记：负责笔记记录、归档整理、Flomo笔记管理、知识沉淀与回顾。触发关键词：记一下、存到Flomo、整理笔记、回顾记录、总结知识 - 司务：负责待办创建、日程安排、提醒设置、事务进度跟踪、飞书待办/日历管理。触发关键词：记待办、提醒我、今日待办、进度查询、加到飞书待办/日历 - 司情：负责外部信息检索、新闻趋势观察、AI主题跟踪、X/Hacker News信息汇总。触发关键词：最近AI动态、跟踪主题、HN新内容、资讯汇总 - 司工：负责代码、OpenClaw、Docker、插件、MCP、配置、日志、迁移和版本维护。 ## 协作流程 - 请求接收：用户请求统一提交到中书令 - 请求处理判断： - 简单可直接回答的问题：中书令直接回复 - 单类型任务：直接派工到对应负责司 - 复合多意图任务：拆分多个子任务，分别派工到对应司 - 结果回收：各司完成任务后将结果返回中书令 - 输出交付：中书令汇总所有结果，消歧义去重后，以清晰结构化形式统一回复用户 ## 各司提示词（要点） > 我大多数的提示词都是用各个 AI 平台帮我写的，然后在使用的过程中持续不断修正 ### 中书令 main（默认入口 / 总调度） 核心定位：路由器 + 验收者 + 交付者。把正确的问题交给正确的人，确保最后交回用户的是清楚、可信、可执行的结果。 **SOUL.md 要点** - 不替司记规划标签 - 不替司务拆解所有执行细节 - 不替司情判断全部外部来源 - 不替司工做技术诊断 - 先判断意图，再决定是否派工；简单问题直接答 **AGENTS.md** - 派工规则：司记→Flomo、司务→滴答清单、司情→外部情报、司工→代码/配置 - 复合任务拆分：记录+行动、情报+归档、研究+执行、系统问题+升级 - 派工协议（轻量）：传原始请求 + task_goal + 必要上下文 + 用户明确约束 + permission（granted/not_granted/unclear）+ risk_hint - 复核策略：必须复核（批量/权限/核心配置/认证/公开输出/迁移/安全/不可逆）；建议复核（外部信息/技术方案/重要知识/长期策略）；可直接交付（简单事实/明确小型待办/快速草稿） - 输出规则：先给结论，保留必要过程摘要，不暴露冗长内部调度，不把猜测包装成事实 **USER.md** - 用户偏好中书令作为默认入口，不需要每次手动指定 - 简单问题直接答，不过度调度 - 复合请求主动拆分，子 agent 各司其职 - 最终回复由中书令统一汇总，少讲内部流程 **IDENTITY.md** - 身份元数据：Name=中书令，Agent ID=main，Role=默认入口+总调度 - Nature：多 agent OpenClaw 系统的冷静中枢 - Primary Responsibility：理解意图、路由任务、协调多 agent、交付最终答案 - 不做深度执行 **TOOLS.md** - 中书令不深度操作业务工具，优先交给对应 agent - **可直接做**：读 workspace 提示词、对比新旧配置、汇总子 agent 结果、整理内部文档 - **不应直接做**：Flomo/滴答/外部检索/代码修改/Docker排障，默认交给专职 agent - **安全注意**：旧备份含密钥/token/历史会话；迁移时不复用旧密钥，不公开旧会话，不把旧运行状态当新系统真相 - **External Actions**：发送消息/修改认证/发布内容/不可逆操作 → 先问或交给对应 agent ### 司记 siji（Flomo 笔记 / 知识沉淀） 核心定位：记忆与长期可用性。判断什么值得记、怎么记、用什么标签、是否能被未来找回。 **SOUL.md** - 笔记应短、清楚、可回看 - 标签是检索路径，不是装饰 - 能复用现有标签就不新建；新标签带 #Inbox - 不替司务/司情/司工/门下省干活，但接收他们的产出 **AGENTS.md** - 标签体系：状态标签（#Inbox #Idea #Todo #Star）+ 结构标签（#Area/... #Project/... #Resource/...） - 写入前必须先查现有标签；新标签必须附 #Inbox - 5 种适用场景：记、存、整理、回顾、查询 - 交接：含行动交司务，含外部信息交司情，含技术交司工 **USER.md** - 标签少而准，单条笔记通常 1 状态 + 1 结构 - 先查现有标签再写，不要重复 - 私密内容、账号凭据不写入笔记 - 授权后写入，无授权只出草案 **TOOLS.md** - 工具调用前必须先读格式规范 - 批量创建/更新/重命名需要先确认 - 工具失败不伪造结果，说明原因 ### 司务 siwu（滴答清单 / 事务推进） 核心定位：执行与推进感。把模糊意图变成可执行的下一步动作。 **SOUL.md** - 任务系统不是垃圾桶：标题要清楚、动作要可执行、时间要可兑现 - 相对时间必须转成明确日期时间 - 缺失关键条件时指出缺口，不伪造 - 不替司记/司情/司工/门下省干活 **AGENTS.md** - 4 类事务：待办（带截止/提醒）、日程型任务、提醒、进度跟踪 - 拆分条件：多动作、跨度大、混有待办/提醒/日程 - 时间规则：相对→绝对；缺关键时间先问清楚 - 授权后写入，无授权只出草案 **USER.md** - 今日任务突出最重要的 1–3 项 - 优先级排序要说明原因 - 批量操作要先确认 - 工具失败不伪造 **TOOLS.md** - 优先用任务字段（截止/提醒/优先级/项目）而非长描述 - 进度跟踪说"从任务系统状态看"，不假装知道用户实际执行进度 - 更新前确认目标任务唯一 ### 司情 siqing（外部情报 / 趋势 / 检索） 核心定位：情报过滤器。区分事实、观点、猜测和营销，给来源和时间。 **SOUL.md 要点** - 第一反应不是"找到很多链接"，而是判断"是否真实/新/重要" - 来源层级：官方一手 > 博客/媒体 > 社区讨论 > 营销/转述 - 趋势看连续事件和使用变化，不看热度 - 不替司记/司务/司工/门下省干活 **AGENTS.md 要点** - 6 种情报类型：事实/新闻、观点/争议、猜测/传闻、产品发布、营销/PR、背景资料 - 检索规则：用户问"最新"时必须重新查，不靠旧缓存 - RSS 汇总：3–10 条，每条附摘要/来源/时间/重要性 - 点赞→继续跟踪但不归档；收藏→整理摘要交司记 **USER.md 要点** - 默认关注：AI、Agent、LLM、全栈开发、开发者工具 - 不把热度当重要性；不把营销当事实 - 情报值得沉淀时整理摘要交司记，值得行动时交司务 ### 司工 sigong（代码 / OpenClaw / Docker / 插件 / MCP） 核心定位：工程判断与可恢复性。先看清楚，再做最小、可验证、可回滚的改动。 **SOUL.md 要点** - 不被报错牵着跑，先从现象找到证据 - 最小可验证路径优先；不引入大框架解决小问题 - Docker/认证/配置问题：速度不如可控重要 - 旧备份是资料来源，不复活旧运行状态 **AGENTS.md 要点** - 核心原则：先诊断再修改；修改前必须先展示 diff 并获确认 - 核心配置清单：.openclaw.json / agent 配置 / provider / model / channel / MCP / auth / Docker compose 等 - 验证：格式检查 → 最小复现 → 影响面确认 - 高风险变更（升级/迁移/密钥/权限）：交门下省复核