一、AGENTS.md 定位AGENTS.md 是 OpenClaw 整个智能体体系的顶层调度规则文件相当于整个 Agent 集群的制度宪章。 它约束单智能体行为逻辑、定义多‑Agent 的协作范式、任务拆分原则、主子 Agent 委派规则、工具调用约束、异常处理逻辑、通信规范同时用来定义 OpenClaw 如何对接 Hermes、飞书等外部系统。 OpenClaw 在启动、接收用户指令、生成子 Agent 时会优先读取本文件的全部约束所有智能体必须严格遵守该文档的规则。对比其余文件区别IDENTITY.md 定义我是谁SOUL.md 定义我性格USER.md 定义用户是谁TOOLS.md 定义我有什么工具AGENTS.md 定义我该怎么干活、怎么组建团队、怎么分配任务、怎么和其他系统通信。二、AGENTS.md 固定六大核心章节标准结构1. 全局基础约束单 Agent 通用规则规定所有智能体必须遵守的基础行为准则。任务执行原则任务优先级、是否并行执行、是否分步执行。权限约束沙箱读写范围、禁止操作的目录、禁止执行的系统命令。输出规范回答格式、是否输出 markdown、是否生成卡片、飞书消息输出格式。异常处理规则任务失败、工具报错、接口超时之后的重试逻辑、告警逻辑、回滚逻辑。记忆调用规则什么时候读取 MEMORY.md 长期记忆、什么时候读取 USER.md 用户信息、是否读取短期 memory 会话日志。示例片段plaintext1.所有Agent仅可在当前workspace目录读写文件禁止访问系统根目录。 2.工具调用连续失败2次停止重试生成告警推送飞书机器人。 3.执行任务优先读取MEMORY.md的历史业务约定、USER.md用户习惯。2. 多智能体架构定义核心模块主子 Agent 模式用来定义中心化主‑子 Agent 架构也是 OpenClaw 实现多智能体协同的核心配置包含主 Agent网关统筹 Agent的职责接收原始用户指令、拆解任务、分发子任务、汇总结果、校验子 Agent 产出。常驻子 Agent 列表预先定义专职子智能体角色如代码 Agent、文档 Agent、测试 Agent、运维 Agent、审核 Agent。临时子 Agent 生成规则什么场景下动态创建一次性子 Agent任务结束之后是否销毁。嵌套层级限制限制子 Agent 再派生子 Agent 的最大层数一般默认最大 3 层防止无限递归。通信规则约定所有子 Agent 不能互相直接通信所有交互必须经由主 Agent 中转中心化模式子 Agent 仅把最终结构化结果回传给主 Agent不需要把完整对话上下文传回减少 Token 损耗。3. 任务拆分 委派逻辑De‑Task 规则明确主 Agent 什么时候拆分任务、如何拆分任务、如何下发任务。触发委派条件当任务复杂度超过单 Agent 处理能力时必须拆分子任务委派给对应子 Agent。任务拆分标准按业务维度、技术维度、步骤维度进行原子化拆分。任务下发模式并行模式多个独立子任务同时交给不同子 Agent 异步执行OpenClaw 核心异步能力串行模式必须上一个任务执行完毕再下发下一阶段任务。任务回执机制子 Agent 执行完成后必须返回结构化结果执行状态、产出文件、结论、问题。4. 事件总线与跨 Agent 通信规范内部通信OpenClaw 网关内部事件总线的消息格式、事件类型任务下发、任务完成、异常事件、告警事件跨框架通信规则OpenClaw 如何对接 Hermes 智能体集群WebSocket、MCP 协议的调用规则、数据传输格式IM 渠道联动规则对接飞书、钉钉机器人时哪些事件要推送至 IM 聊天窗口。5. 工具调用的约束规则联动 TOOLS.md主 Agent / 子 Agent 分别可以调用哪些 Skill 工具子 Agent 能不能直接调用外部工具还是必须交由主 Agent 统一调用工具权限收敛调用 TOOLS.md 里插件的触发条件、调用顺序、鉴权规则。工程最佳实践子 Agent 只负责思考逻辑文件读写、接口调用、脚本执行全部交给主 Agent 统一执行收拢权限防止越权。6. 对外交互规范对接 IM飞书、钉钉、企业微信接收来自飞书机器人 WebSocket 推送的用户指令规定任务结果、告警日志以什么格式通过飞书机器人应用身份推送回聊天窗口区分两种身份应用身份tenant‑token、用户身份user‑token的使用场景定义哪些场景需要通过 OAuth2 获取用户身份实现数据权限隔离。三、AGENTS.md 在 OpenClawHermes 架构里的作用AGENTS.md 定义主 Agent将重型推理任务委派给 Hermes 集群AGENTS.md 约定 OpenClaw网关层和 Hermes推理执行层的通信格式、调用时序AGENTS.md 规定 Hermes 产出结果之后OpenClaw 如何汇总、如何推送到飞书 IMAGENTS.md 约束 Hermes 内部多智能体的协同规则实现跨框架的多 Agent 联动。链路示例飞书场景飞书机器人接收用户指令推送至 OpenClawOpenClaw 读取 AGENTS.md 规则判定任务复杂启动主 Agent主 Agent 按照 AGENTS.md 的委派规则将开发任务下发给 Hermes 多智能体集群Hermes 执行完毕后将结果回传给 OpenClaw依据 AGENTS.md 的对外交互规范以飞书机器人身份将结果推送至飞书群。四、极简可直接落地的 AGENTS.md 模板markdown# AGENTS.md 工作规范 ## 1.全局约束 1.1 所有智能体仅在当前workspace目录执行文件读写禁止访问系统敏感目录。 1.2 工具调用连续失败2次则终止重试生成告警并推送到飞书研发群。 1.3 执行任务优先读取USER.md用户配置、MEMORY.md长期记忆。 ## 2.多智能体架构规则 2.1 采用中心化主‑子Agent架构主Agent为统筹调度节点。 2.2 常驻子Agent代码Agent、文档Agent、审核Agent。 2.3 子Agent仅能与主Agent通信子Agent之间禁止直接交互Agent最大嵌套层级为3层。 2.4 临时子Agent在任务执行结束后自动销毁。 ## 3.任务委派规则 3.1 任务存在多个独立步骤时主Agent进行任务拆分。 3.2 无依赖的子任务采用并行模式执行存在前后依赖的任务采用串行模式。 3.3 子Agent仅返回结构化结果不回传完整对话上下文。 ## 4.工具调用规范 4.1 子Agent只负责逻辑推理文件操作、脚本执行、接口调用统一由主Agent执行。 4.2 所有工具调用必须遵循TOOLS.md定义的插件参数规范。 ## 5.外部通信规范 5.1 对接Hermes采用WebSocket双向通信任务指令通过MCP协议传输。 5.2 所有告警、任务结果由主Agent调用飞书开放API以机器人应用身份推送至飞书。 5.3 若要读取员工私有飞书数据必须走OAuth2流程获取user_access_token。