OpenClaw 配置 ACP 调用 Claude Code / Codex 完整教程

让编码任务在独立会话里运行，随时随地用手机指挥 AI 写代码

这能带来什么？

配置完成后，你可以在任何地方——手机、iPad、咖啡馆——通过手机给 OpenClaw 发一条消息，让服务器上的 Claude Code 或 Codex 帮你写代码、改文件、跑测试。

你不再需要坐在电脑前才能用 Claude Code 或 Codex 写代码。

这就是数字游民的工作方式：AI 在服务器上干活，你在任何地方指挥。

解决方案就是来自 OpenClaw 官方的 ACPX 插件实现。

场景	没有 ACP	有 ACP
长时间编码任务	主 Agent 阻塞，群消息无法回复	独立会话，主 Agent 保持响应 ✅
多任务并行	只能排队等	多个会话同时跑 ✅
上下文管理	所有对话混在一起	每个任务独立上下文 ✅

前置条件

openclaw --version  # 要求 2026.3.28+
claude --version    # 已安装 Claude Code
node --version      # Node.js 22+

如果还没安装 Claude Code 或 Codex：

# Claude Code
npm install -g @anthropic-ai/claude-code
# Codex CLI（可选）
npm install -g @openai/codex

Step 1：安装 acpx

acpx 是连接 OpenClaw 和 CLI Agent 的桥梁，独立 npm 包：

npm install -g acpx@latest

验证安装：

npx acpx@latest --version

Step 2：配置 OpenClaw

编辑 ~/.openclaw/openclaw.json，加入以下配置（合并到现有内容）：

{
  "acp": {
    "enabled": true,
    "backend": "acpx",
    "defaultAgent": "claude",
    "allowedAgents": ["claude", "codex"]
  },
  "plugins": {
    "enabled": true,
    "allow": ["acpx"],
    "entries": {
      "acpx": { "enabled": true }
    }
  }
}

重启 Gateway：

openclaw gateway restart

Step 3：让 Claude Code 帮你配（推荐）

不想手动改配置？进入 OpenClaw 配置目录，启动 Claude Code：

cd ~/.openclaw
claude

把下面这段话粘贴给它，让它帮你完成所有配置并验证：

请帮我配置 OpenClaw 的 ACP 功能。

1. 先运行：npm install -g acpx@latest

2. 编辑 ~/.openclaw/openclaw.json，合并以下配置（不要覆盖其他字段）：
{
  "acp": {
    "enabled": true,
    "backend": "acpx",
    "defaultAgent": "claude",
    "allowedAgents": ["claude", "codex"]
  },
  "plugins": {
    "enabled": true,
    "allow": ["acpx"],
    "entries": {
      "acpx": { "enabled": true }
    }
  }
}

3. 运行 openclaw gateway restart 重启 Gateway

4. 验证：
   - openclaw plugins list | grep acpx（期望显示 loaded）
   - openclaw acp --help（期望显示帮助信息）
   - npx acpx@latest --version（期望显示版本号）

请执行以上步骤并告诉我每步的结果。

验证配置

# 插件加载成功（期望显示 loaded）
openclaw plugins list | grep acpx

# ACP 命令可用
openclaw acp --help

# acpx 可用
npx acpx@latest --version

开始使用

在聊天窗口直接说

帮我用 Claude Code 分析这个项目
启动一个 codex 会话修复 login 模块的 bug

命令行直接调用

# 用 Claude Code 执行任务
npx acpx@latest claude "refactor the auth module"

# 用 Codex 执行任务
npx acpx@latest codex "fix the failing tests"

# 一次性任务
npx acpx@latest codex exec "one-shot: summarize this repo"

并行多个任务

启动一个 claude 会话重构 auth 模块，
再启动一个 codex 会话修复 failing tests

两个任务并行跑，你随时可以问其他问题，主 Agent 不会被阻塞。

常见问题

acpx 插件显示 disabled？

检查 plugins.allow 数组是否包含 "acpx"，以及 plugins.entries.acpx.enabled 是否为 true，然后重启 Gateway。

Gateway 重启失败？

验证 JSON 格式：

cat ~/.openclaw/openclaw.json | jq .

有语法错误会直接报出来，修复后再重启。

ACP 会话无法启动？

openclaw gateway logs | grep -i acp

日常维护也交给 AI

cd ~/.openclaw && claude

直接说：帮我检查 openclaw 配置 / 优化我的 cron / 排查连接问题

Agent 帮你调 Agent，你只需要发消息。