2026年ACP (Agent Client Protocol) 配置完整指南

科技前沿 • 2026-03-18 20:45 • 阅读 0

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 ACP (Agent Client Protocol) 是一个开放协议,用来规范 AI Agent 与代码编辑器/IDE 之间的通信方式。它类似于 Language Server Protocol (LSP),但专注于 AI 代理的集成,帮助开发者在不同编辑器中使用各种 AI 工具,而无需为每个组合构建自定义适配器。

在没有 ACP 之前,每个 AI Agent 想接入某个 IDE,都需要单独开发适配器:

Claude Code 要写一套适配器
Cursor 要写一套适配器
Windsurf 也要写一套适配器

这导致重复造轮子,而且一旦 Agent 更新,适配器还得跟着改。

ACP 的核心思路: 定义一套标准的通信协议,任何 Agent 只要实现了 ACP Server,任何 IDE 只要实现了 ACP Client,两者就能直接对接。

OpenClaw CLI: 已安装并配置
Claude Code CLI (可选): 如果要调用 Claude Code
Codex CLI (可选): 如果要调用 Codex
Node.js: v16 或更高版本

第一步:安装 acpx 插件

GPT plus 代充 只需 145openclaw plugins install @openclaw/acpx

第二步:配置 OpenClaw

使用命令行配置:

# 启用 acpx 插件 openclaw config set plugins.entries.acpx.enabled true

设置权限模式(自动批准所有操作)

openclaw config set plugins.entries.acpx.config.permissionMode approve-all

启用 ACP 功能

openclaw config set acp.enabled true openclaw config set acp.dispatch.enabled true openclaw config set acp.backend acpx

设置默认 Agent

openclaw config set acp.defaultAgent claude

或者直接编辑 ~/.openclaw/config.json:

GPT plus 代充 只需 145{ "plugins": {

"entries": { "acpx": { "enabled": true, "config": { "permissionMode": "approve-all" } } }

}, "acp": {

GPT plus 代充 只需 145"enabled": true, "dispatch": { "enabled": true }, "backend": "acpx", "defaultAgent": "claude"

} }

第三步:重启 Gateway

# 重启 OpenClaw Gateway 使配置生效 openclaw restart

第四步:验证配置

GPT plus 代充 只需 145# 检查 ACP 状态 /acp doctor

启动一个持久化的 Claude 会话

/acp spawn claude –mode persistent –thread auto

方法一:直接对话

你: "用 Claude Code 帮我重构这个函数"

OpenClaw 会自动走 ACP 路由到 Claude Code(如果你配置了 acp.defaultAgent: claude)。

方法二:手动 spawn 会话

GPT plus 代充 只需 145/acp spawn claude –mode persistent –thread auto

然后在同一 thread 里继续对话,所有内容会发给 Claude Code。

方法三:用 sessions_spawn 工具

{ "task": "帮我写个测试", "runtime": "acp", "agentId": "claude", "thread": true, "mode": "session" }

命令作用 /acp status 查看当前会话状态

/acp steer 
     <指令>

发送 steer 指令给正在运行的会话 /acp cancel 取消当前 turn /acp close 关闭会话

⚠️ ACP 会话是非交互式的,所以 permissionMode: approve-all 是必须的,否则写文件/exec 命令会失败。

⚠️ ACP Binding 目前不支持飞书

GPT plus 代充 只需 145# 安装插件 openclaw plugins install @openclaw/acpx

配置

openclaw config set plugins.entries.acpx.enabled true openclaw config set plugins.entries.acpx.config.permissionMode approve-all openclaw config set acp.enabled true openclaw config set acp.dispatch.enabled true openclaw config set acp.backend acpx openclaw config set acp.defaultAgent claude

重启

openclaw restart

验证

/acp doctor