需采用“四角架构”构建openclaw多agent系统,即通过定义dispatcher、executor、reviewer、overseer四类角色,配置agent.md行为约束、启用subagents权限与全局memory共享、绑定消息路由及状态通道,并完成端到端流程验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在OpenClaw中构建具备明确层级、职责闭环与动态协同能力的多Agent系统,则需突破基础角色添加,进入结构化架构设计阶段。“四角架构”即总调度、执行、审查、管理四类Agent协同运转的高阶配置模式,其核心在于权限开放、记忆共享与状态驱动的任务流转。以下是实现该架构的具体配置步骤:
一、定义四角角色并创建独立Agent实例
每个“角”对应一个语义清晰、职责不可重叠的Agent实体,需通过命令行分别初始化,并确保其工作空间物理隔离。此步骤奠定角色边界基础,防止后续行为越界或指令混淆。
1、执行以下命令创建四个Agent,ID严格对应架构定位:
openclaw agents add dispatcher --workspace ~/.openclaw/workspace-dispatcher
openclaw agents add executor --workspace ~/.openclaw/workspace-executor
2、openclaw agents add reviewer --workspace ~/.openclaw/workspace-reviewer
3、openclaw agents add overseer --workspace ~/.openclaw/workspace-overseer
二、配置agent.md明确角色灵魂与行为红线
每个Agent的agent.md文件是其决策依据,必须用自然语言精确约束其能力范围与协作方式,避免模糊表述引发跨角越权。所有描述需以“你是一个…”开头,禁用条件句与假设性表达。
1、dispatcher/agent.md中写入:你是一个总调度员。你只接收用户原始输入,解析意图后必须使用@executor调用执行任务,或使用@reviewer触发审核流程。禁止自行生成结果或修改他人输出。
2、executor/agent.md中写入:你是一个执行专家。你仅响应@dispatcher的明确指派,按指令完成代码编写、内容生成或数据处理。输出必须为可执行产物(如代码块、Markdown正文、JSON结构),不附带解释性文字。
3、reviewer/agent.md中写入:你是一个审查者。你只处理来自@executor的交付物,逐项核对格式合规性、逻辑一致性与安全红线。仅返回PASS/REJECT及具体缺陷编号,不参与重写或优化。
4、overseer/agent.md中写入:你是一个管理者。你每18分钟扫描一次全局任务状态表,对超时未完成任务向@dispatcher发送预警,对连续两次REJECT的任务启动人工介入流程。不接触原始输入与中间产物。
三、启用跨Agent通信与全局记忆共享
默认状态下OpenClaw禁止Agent间直接交互,必须显式开启子Agent调用权限并挂载共享记忆路径,否则四角无法形成闭环。此配置位于全局主配置文件~/.openclaw/openclaw.json中,属于架构生效前提。
1、打开~/.openclaw/openclaw.json,在agents.list数组内为每个Agent添加subagents.allowAgents字段:
2、dispatcher配置中设置:"subagents": {"allowAgents": ["executor", "reviewer"]}
3、overseer配置中设置:"subagents": {"allowAgents": ["dispatcher"]}
4、在根级配置中添加memory全局段:"memory": {"sharedPath": "~/.openclaw/memory-global", "autoSync": true}
四、绑定消息路由与状态监控通道
四角架构依赖消息精准落位与状态实时可见,需将不同渠道消息定向至对应Agent,并为overseer配置专用状态监听端口。路由错误将导致任务流断裂,监控缺失则使闭环失效。
1、为dispatcher绑定用户入口渠道(如Telegram私聊):openclaw bindings add telegram:personal dispatcher
2、为reviewer绑定审核专用群组(如Telegram技术审核群):openclaw bindings add telegram:review-channel reviewer
3、为overseer启用状态轮询通道:openclaw channels add cron --interval 18m --handler overseer:check_status
4、确认所有binding规则已加载:openclaw bindings list
五、验证四角协同流程是否就绪
架构部署完成后必须进行端到端流程验证,重点观测任务是否自动穿越四个角色、状态是否同步更新、失败路径是否触发预警。任何环节卡顿均表明某角配置未生效或权限未放通。
1、向dispatcher发送测试指令:“生成一个React useState示例并检查语法”
2、观察executor是否在3秒内返回代码块
3、确认reviewer是否在5秒内输出“PASS”或缺陷编号列表
4、检查overseer是否在日志中记录本次任务ID与耗时
5、手动中断executor响应,验证overseer是否在18分钟后推送超时预警










