OpenClaw ACP 的核心问题与实现机制

核心问题

1. 工具碎片化与集成成本高昂

   • 每个代码编辑器或 IDE 需要为不同 AI 代理编写定制集成代码
   • 导致高集成成本、有限兼容性和厂商锁定

2. 上下文缺失与工作流中断

   • AI 编程助手在会话间无法维持上下文
   • 开发者需要重复提供背景信息

3. 平台能力受限

   • OpenClaw 原生子代理受沙盒安全和工具集限制
   • 专业编码工具（如 Claude Code）孤立运行

4. 专业 AI 代理难以协作

   • 难以集成到团队协作平台（如 Slack/Discord）
   • 无法利用 OpenClaw 的路由和记忆管理能力

5. 通用协议对 AI 支持不足

   • REST/gRPC 难以支持服务端主动推送、流式输出
   • 缺乏内置幂等性和会话上下文支持

6. 多代理调试困难

   • 复杂工作流中难以追踪问题根源

核心机制

1. 标准化通信协议

   • 基于 JSON-RPC 2.0 的双向事件协议

2. 桥接架构

   • openclaw acp 命令行工具作为 IDE 与 Gateway 的桥梁

3. 会话管理

   • 映射 ACP 会话到 Gateway 会话键
   • 支持会话标签和隔离机制

4. 服务端事件推送

   • 主动推送 assistant.text.delta 等事件

5. 多渠道一致性

   • 标准化消息格式保证 Web/WhatsApp/CLI 体验一致

6. 外部代理集成

   • 通过 acpx 运行外部编码工具（如 Claude Code）

7. 溯源跟踪 ID

   • 元数据跟踪命令来源和路径

---

实现机制

• 命令行工具：openclaw acp 通过 stdio 与 IDE 通信
• WebSocket 通信：转发提示到 Gateway
• 会话存储：管理创建/加载/淘汰机制
• 策略守卫：policy.ts 控制功能启用和访问权限
• SDK 集成：使用官方 @agentclientprotocol/sdk