OpenClaw ACP 协议详解

OpenClaw 的 ACP 协议 是 OpenClaw 项目中一个非常重要的基础设施升级，全称 Agent Client Protocol（代理客户端协议），也被称为 Agent Communication Protocol（代理通信协议），具体取决于上下文。

它本质上是一个标准化通信协议，专门为 AI Agent（智能体）场景设计，主要解决 IDE（如 VS Code、Zed 等）与 AI 代理之间的直接、高效、结构化通信问题。

ACP 的核心作用（一句话总结）

让你的代码编辑器直接驱动 OpenClaw 的 AI Agent（或外部编码代理如 Claude Code、Qwen Code、Codex 等），无需频繁切换到终端或浏览器，所有交互都在编辑器内完成。

两种常见的 ACP 使用场景（OpenClaw 生态里最常见的两种含义）

1. 作为客户端桥接协议（最常见用法，2026 年主流玩法）
• 命令：openclaw acp
• 作用：启动一个 ACP 桥（bridge），通过 stdio（标准输入输出）与 IDE 通信，再把请求转发到 OpenClaw Gateway（WebSocket）。
• 相当于在 VS Code / Zed 里装个插件或配置后，就能像使用 Copilot 一样直接调用 OpenClaw 的 Agent，甚至调用外部的 Claude Code / Qwen Code / Gemini CLI 等。
• 最大优势：协议层不消耗 Token，只有实际调用的 LLM 才会花钱。
2. 作为 Agent 间的通信协议（ACP Agent / 多代理协作）
   OpenClaw 内部把支持 ACP 的外部工具/代理称为 ACP Agent。 主 Agent 可以派发任务给这些外部专业编码 Agent（如 Qwen Code 写 C#、Claude Code 写前端），实现零额外 Token 消耗的“借力打力”。 这和 Sub-Agent（内部子代理）是并列的高级玩法。

简单对比（2026 年 OpenClaw 三大 Agent 类型）

快速上手步骤（最常见 VS Code + OpenClaw ACP 玩法）

1. 确保 OpenClaw 已安装并运行（openclaw onboard 或 openclaw start）。
2. 安装支持 ACP 的 VS Code 扩展（例如 “ACP Client” 或社区类似插件，已支持 OpenClaw）。
3. 终端运行：

   text

   openclaw acp

   （保持这个进程活着，它就是桥）
4. 在扩展设置里选择 runtime = "acp"，指定 gateway 或默认 agent（如 qwen-code、claude-code）。
5. 在代码里选中一段，按快捷键或右键 → “Ask OpenClaw / Ask Qwen Code via ACP”。

更多配置示例（~/.openclaw/config/gateway.json）：

JSON

{
  "acp": {
    "defaultAgent": "qwen-code",
    "allowedAgents": ["qwen-code", "claude-code", "codex", "main"],
    "maxConcurrentSessions": 5,
    "permissionMode": "approval",
    "nonInteractivePermissions": "fail"
  }
}

一句话总结 2026 年 OpenClaw ACP 的定位：它让 OpenClaw 从“聊天机器人”升级成了“可被任何编辑器直接调用的、可互相协作的 AI 代理操作系统”。

想深入某个具体用法（比如怎么配置调用 Claude Code、怎么写 agents.md 规则、怎么处理权限），可以继续问我！🦞