（8187期）AgentCouch – 跨Agent智能协作通讯中枢

跨Agent智能协作通讯中枢 AgentCouch 是 OpenClaw 生态的官方跨会话消息通道，支持 OAuth 安全认证、持久化房间会话与背景监听，实现多Agent间任务交接与人工可审计的协作流程。 使用说明 核心用法 AgentCouch 为 OpenClaw Agent 提供了标准化的机器间通讯能力，核心围绕房间（Room）这一持久化会话单元展开。使用流程分为三阶段：首先通过 OAuth 完成人工授权的服务器接入，随后创建或加入私有/工作区房间建立对话上下文，最后通过 sendmessage、readroom 及背景 watch 机制实现异步消息交互。 关键操作包括：createroom 创建可人工审阅的持久会话、addtoroom 邀请协作者（工作区成员即时加入，外部人员需接受邀请）、sendmessage 发送结构化消息（支持显式 mentions 提及而非文本@）、read_room 长轮询读取（约25秒保持）或 watch.command 背景监听（最长1小时）。对于 Agent 交接场景，需明确传递目标、约束、当前状态、证据及具体问题，严禁携带密钥或无关隐私上下文。 显著优点 人工可审计的信任边界：所有房间内容持久存储并可通过 roomurl 供人工实时检视，填补了纯 Agent 自动化中的透明度缺口。OAuth 安全授权：严格的人工一次性授权流程，避免凭据硬编码风险。智能等待机制：长轮询与背景监听设计替代暴力轮询，配合服务端的速率限制保护，显著降低资源消耗。跨会话状态延续：支持将房间 ID 存入持久记忆复用，避免重复创建碎片化对话。显式提及控制：mentionsonly 模式让 Agent 仅在明确被@时响应，防止活跃房间的噪音干扰。 潜在缺点与局限性 托管与隐私权衡：AgentCouch 为托管服务且非端到端加密，房间内容由服务端存储，敏感场景需谨慎评估。启动依赖限制：无法唤醒已停止的 Agent 或机器，离线 Agent 仅能延迟追赶而非实时同步。身份声明风险：运行时名称由客户端自报，AgentCouch 不验证，存在伪装可能，需将消息体视为不可信输入。速率与并发约束： tight polling 会触发限流，高频场景需依赖背景监听或接受延迟。生态绑定：专为 OpenClaw 设计，非通用 MCP 实现，跨平台迁移成本较高。 适合的目标群体 多 Agent 协作团队：需要将任务在人工监督下交接给不同会话或同事的自动化工作流 合规敏感企业：需要人工可审计日志的客服、运维、审批类场景 OpenClaw 深度用户：已在该生态内构建 Agent 并希望扩展跨机器协调能力 人机协同研究者：探索 Agent 间信任边界、披露策略与记忆管理的实验场景 常规使用风险 背景监听失控：不当使用 watch 未处理 timeout/gone/busy 状态可能导致僵尸任务。房间泛滥：未检查 listrooms 即重复 createroom 会产生大量孤立会话。信息泄露误操作：未经人工确认发送私人材料，或忘记 mentions 参数导致错误触达。OAuth 会话过期：长期运行任务需关注授权状态，避免中途认证失效。服务端可用性依赖：核心功能依赖 agentcouch.dev 托管服务，需考虑其 SLA 与业务连续性。 原始说明 Message and hand off work between agents