📦 Inter Agent Communication — 代理会话互通

技能文档

# Agent 通信 ## ⚠️ 重要规则 禁止复用 人类-Agent 的对话会话！ - 人类-Agent 会话格式：agent:xxx:feishu:direct:ou_xxx - Agent 之间调用必须使用 sessions_spawn 创建子 Agent 会话 --- ## 严格流程（不可跳过） ### 第 1 步：检查已有会话 ``javascript sessions_list({ limit: 50 }) ` 在结果中查找： - 包含 "subagent" 标记 - label 匹配 发送方-to-接收方 或 接收方-to-发送方（双向检查） 示例： - 若 main 想查找 sienna，查找 main-to-sienna 或 sienna-to-main - 任意一个即可，无需新建 ### 第 2 步：创建新会话（若未找到） 若第 1 步无结果，用 sessions_spawn 创建： `javascript sessions_spawn({ label: "main-to-sienna", // 格式：发送方-to-接收方 runtime: "subagent", task: "", // 任务放在第 3 步 mode: "run" }) ` ### 第 3 步：发送消息 `javascript sessions_send({ sessionKey: "agent:main:subagent:xxx", // 来自第 1 或 2 步 message: "任务描述..." // 实际任务写这里 }) ` --- ## ⚡ 关键规则（必须遵守） 1. 不得跳过第 1 步：必须先执行 sessions_list 2. 不得走捷径：必须按顺序 1 → 2 → 3 3. 双向复用：a-to-b 与 b-to-a 均可使用，无需两条 4. 直接回复发送方：如无特别指示，直接回复发起者 5. 使用 subagent 标记：sessionKey 必须包含 "subagent" --- ## ❌ 错误示例 `javascript // 错误 1：未检查就创建 sessions_spawn({...}) // 必须先检查！ // 错误 2：使用人类对话会话 sessionKey: "agent:sienna:feishu:direct:ou_xxx" // 禁止！ // 错误 3：双向各建一条 // main-to-sienna 与 sienna-to-main 只需一条！ // 错误 4：回复他人 // 应直接回复发送方，勿转发或群发 ` --- ## SessionKey 格式指南 | 类型 | 格式示例 | 可用于 Agent-Agent？ | |------|----------------|------------------------| | Agent-人类私聊 | agent:sienna:feishu:direct:ou_xxx | ❌ 禁止 | | Agent 群聊 | agent:sienna:feishu:group:oc_xxx | ❌ 禁止 | | 子 Agent 会话 | agent:maxwell:subagent:xxx | ✅ 允许 | --- ## 回复规则 默认：回复直接发送给发起者 - 发起者发消息 → 直接回复发起者 - 无需转发给他人 - 无需发到群里 - 除非发起者明确要求转发 --- ## 工作流伪代码 ` 1. 调用 sessions_list({ limit: 50 }) 2. 遍历结果，查找同时满足： - 包含 "subagent" 标记 - label 为 "发送方-to-接收方" 或 "接收方-to-发送方" 3. 找到 → 使用该 sessionKey，跳转第 5 步 4. 未找到 → 用 sessions_spawn 创建，保存 sessionKey 5. 调用 sessions_send({ sessionKey, message }) 6. 完成 ` --- ## 当前活跃通道（参考） | Agent | Label | sessionId | |-------|-------|-----------| | leo | maxwell-to-leo | 9d519dc9-0239-4284-8077-3ed4bccd486d | | sienna | maxwell-to-sienna | 05a93e6d-4a50-4503-a9c8-4aaf7da8c414 | | letus | maxwell-to-letus | 391a4a78-43ab-4e04-95fe-abfd414b1c64 | | coding | maxwell-to-coding | ebba5ff4-87f6-430b-80e5-269319b122c0 | | main | maxwell-to-main | d7eb2edc-7acc-40e7-838d-8a9cb08820c0 | --- ## 注意事项 - thread=true 模式暂不可用 - 带 label 的子 Agent 会话可通过 sessions_list 找到 - mode="session" 需要 thread=true，目前不可用 --- # 会话保护机制（新增） ## 第 2.5 步：保护会话（创建后执行） 新建的子 Agent 会话默认可能被自动清理。为确保长期可用，创建后需立即保护： `javascript // 防止会话被自动清理 exec({ command: openclaw sessions cleanup --agent [target-agent] --active-key "${sessionKey}" --enforce }) ` > 注意：将 ${sessionKey} 替换为实际 sessionKey --- ## 完整流程（含保护） ### 第 1 步：检查已有会话 `javascript sessions_list({ limit: 50 }) ` ### 第 2 步：创建新会话（若未找到） `javascript sessions_spawn({ label: "main-to-sienna", runtime: "subagent", task: "", mode: "run" }) // 返回 sessionKey，格式：agent:xxx:subagent:xxx ` ### 第 2.5 步：保护会话（新增） `javascript exec({ command: openclaw sessions cleanup --active-key "agent:xxx:subagent:xxx" --enforce }) ` ### 第 3 步：发送消息 `javascript sessions_send({ sessionKey: "agent:main:subagent:xxx", message: "任务描述..." }) `` --- _最后更新：2026-03-17_