OpenClaw 调用 Claude Code和Codex

ACP (Agent Client Protocol) 配置与部署全流程

???? 什么是 ACP?

我们可以用一个精准的技术类比来理解ACP。在代码编辑领域，Language Server Protocol (LSP) 解决了不同编辑器与语言服务器之间的标准化通信问题。同理，ACP (Agent Client Protocol) 就是为AI代理（Agent）与集成开发环境（IDE）之间设计的标准化“语言”。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

ACP的核心是一套开放协议，它明确定义了AI代理与客户端（如代码编辑器）之间的数据交换格式与交互模式。其核心价值在于解耦：开发者可以在自己熟悉的IDE中，直接接入任何遵循ACP协议的AI能力，无需为每一个“AI代理-编辑器”组合进行重复的底层集成开发。

为什么需要 ACP?

在缺乏ACP标准之前，生态集成面临显著的碎片化挑战。每个AI提供商都需要为其代理独立开发针对不同IDE的专用适配插件：

• 为VS Code开发一个，
• 为JetBrains套件再开发一个，
• 新兴编辑器出现时又需重新适配。

这种模式导致了巨大的开发冗余与维护负担。每当代理端更新功能或接口，所有下游适配器都必须同步更新。

ACP通过引入标准化接口层，从根本上改变了这一局面。任何实现ACP Server端的AI代理，都能与任何实现ACP Client端的IDE直接、无损地通信。这大幅降低了集成复杂度，是构建可互操作AI开发生态的关键基础设施。

???? 场景一: 在 OpenClaw 中配置 ACP 以调用 Claude Code 与 Codex

前置条件

开始配置前，请确认你的系统环境已满足以下依赖：

• OpenClaw CLI：已完成安装与基础身份验证。
• 目标AI代理CLI（可选）：如计划调用Claude Code或Codex，需确保其命令行工具已就绪。
• Node.js 运行时：建议使用v16或更高版本以保证兼容性。

配置步骤

第一步:安装 acpx 插件

首先，安装ACP协议的官方执行插件acpx，它为OpenClaw提供了协议解析与路由能力。

openclaw plugins install @openclaw/acpx

第二步:配置 OpenClaw

通过一组串行命令完成核心设置，包括插件启用、权限模型配置以及ACP后端服务的指定。

# 启用 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
# 指定 ACP 功能的后端实现为 acpx 插件
openclaw config set acp.backend acpx

# 设置默认调用的 AI 代理
openclaw config set acp.defaultAgent claude

你也可以选择直接编辑配置文件 ~/.openclaw/config.json，写入以下结构化配置：

{
  "plugins": {
    "entries": {
      "acpx": {
        "enabled": true,
        "config": {
          "permissionMode": "approve-all"
        }
      }
    }
  },
  "acp": {
    "enabled": true,
    "dispatch": {
      "enabled": true
    },
    "backend": "acpx",
    "defaultAgent": "claude"
  }
}

第三步:重启 Gateway 服务

配置更新后，必须重启OpenClaw Gateway服务以使所有变更生效。

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

第四步:验证配置

使用诊断命令和会话创建命令来验证ACP功能是否已正常启动并可用。

# 运行 ACP 健康检查
/acp doctor

# 创建一个持久化的 Claude 代理会话
/acp spawn claude --mode persistent --thread auto

使用方法

配置完成后，可以通过以下几种模式与AI代理进行交互：

模式一：基于默认代理的直接对话
当已设置acp.defaultAgent后，向OpenClaw发出的自然语言指令将被自动路由至该代理处理。

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

模式二：显式创建持久化会话
通过/acp spawn命令手动启动一个绑定到特定线程的持久会话，后续该线程内所有交互均指向该代理。

/acp spawn claude --mode persistent --thread auto

模式三：通过工具调用发起会话
以结构化JSON参数形式，通过sessions_spawn工具调用启动一个ACP会话。

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

常用 ACP 命令

以下命令用于会话的日常控制与管理，建议掌握：

关键注意事项

有两个技术细节直接影响配置的成功运行，请务必遵循：

⚠️ 权限模式必须设置为 approve-all
由于ACP会话在设计上是非交互式的，Agent在执行文件写入或运行终端命令等操作时，无法实时请求用户授权。因此，将permissionMode设为approve-all是功能正常运行的必要前提。

⚠️ ACP Binding 暂不兼容飞书
当前版本的ACP绑定功能尚未实现在飞书客户端上的支持，在规划集成方案时需考虑此平台限制。

???? ACP 配置快速参考

OpenClaw ACP 配置

以下为完整的命令行配置流程速查表，适用于快速部署或恢复环境：

# 安装插件
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