OpenClaw 与 Qoder CLI 对接指南：在阿里云服务器配置 ACP 实现编码任务自动派发

如果你已经厌倦了手动配置服务器、安装各种工具，那么这份指南正是为你准备的。本文旨在指导你如何利用 Qoder 的一个 Skill（技能文档），自动化完成在阿里云服务器上部署 OpenClaw、配置通讯机器人并与 Qoder CLI 对接的全过程。整个过程清晰、高效，让你能快速进入“让 AI 干活”的状态。

第一步：准备 Qoder 环境

首先，你需要一个能够执行任务的 Qoder。推荐使用 Qoder IDE。

1. 访问 Qoder 官网，使用邮箱注册账号。
2. 验证邮箱，激活账号，新用户通常会获得一定的初始 Credits。
3. 安装或登录 Qoder IDE，这将是你后续操作的主要界面。

第二步：自动化部署 OpenClaw 与机器人

手动部署费时费力，我们将直接利用社区共享的 Skill 文件，让 Qoder 来执行这些重复性工作。

Skills 地址：

https://qoder-community.pages.dev/zh/skills/openclaw/

你只需要将这个 Skill 对应的 Markdown 文档链接或内容，直接发送给你的 Qoder。接下来，Qoder 会引导你完成所有步骤，包括：

• 购买并配置阿里云服务器（ECS）。
• 在服务器上安装 Node.js 运行环境。
• 安装 OpenClaw。
• 配置钉钉或飞书机器人。
• （可选）安装和配置 Qoder CLI。

提示：完成第一、第二步后，核心的安装与基础配置教程已经结束。以下内容是为希望深入了解 ACP（Agent Client Protocol）对接细节，或偏好手动配置的开发者准备的详细指南。

第三步：手动对接 Qoder CLI 与 OpenClaw

OpenClaw 可以作为你日常工作和消息的统一入口，但专业的编码任务，或许你更希望交给像 Qoder CLI 这样专精于 Agentic Coding 的工具。ACP 协议就是连接 OpenClaw（调度者）与 Qoder CLI（执行者）的桥梁，让你无需离开聊天窗口，就能派发和接收编码任务。

什么是 ACP？

ACP 全称 Agent Client Protocol，是 OpenClaw 用于连接外部专业工具（如 Qoder CLI）的协议层。通过 ACP，OpenClaw 可以将编码任务路由给最合适的工具执行，并将结果带回对话。

它与 OpenClaw 自带的 Sub-Agents 分工明确：

对比项	ACP	Sub-Agents
对接对象	外部专业编码工具（如 Qoder CLI）	OpenClaw 自己的内部子代理
会话 key 格式	agent:qoder:acp:<uuid>	agent:<id>:subagent:<uuid>
命令族	/acp ...	/subagents ...
适用场景	大管家把编码任务派给 Qoder 执行	在 OpenClaw 内部做任务拆解、路由、协同

简单来说：让 OpenClaw 给 Qoder 派活儿，用 ACP；在 OpenClaw 体系内进行多代理协作，用 Sub-Agents。

前提条件

开始前，请确保：

1. OpenClaw 已安装并正在运行（执行 openclaw gateway status 应显示正常）。
2. 你已拥有一个有效的 Qoder Personal Access Token（可在 qoder.com 官网的 Settings → API Keys 页面获取）。

对接步骤

Step 1: 安装 ACPX 插件

ACPX 是 OpenClaw 中实现 ACP 协议的后端插件，必须首先安装。

openclaw plugins install @openclaw/acpx
openclaw config set plugins.entries.acpx.enabled true

安装后验证：

openclaw plugins list | grep acpx

应看到类似输出，状态为 loaded：

│ ACPX Runtime │ acpx     │ loaded   │ stock:acpx/index.ts │

Step 2: 启用并配置 ACP

需要一次性设置多个配置项来启用 ACP 并指定 Qoder 为默认代理。

openclaw config set acp.enabled true
openclaw config set acp.dispatch.enabled true
openclaw config set acp.backend "acpx"
openclaw config set acp.defaultAgent "qoder"
openclaw config set acp.allowedAgents '["qoder"]'
openclaw gateway restart

这六条命令的作用是：全局启用 ACP、启用消息调度、设置后端为 acpx、指定 Qoder 为默认代理、将 Qoder 加入白名单，最后重启服务使配置生效。allowedAgents 是白名单，目前只允许 Qoder。

Step 3: 配置 Qoder CLI 启动方式

首先，确保 Qoder CLI 已全局安装：

npm install -g @qoder-ai/qodercli

然后，为 ACPX 创建配置文件，定义如何启动 Qoder CLI：

mkdir -p ~/.acpx
cat > ~/.acpx/config.json << 'EOF'
{
  "agents": {
    "qoder": {
      "command": "env QODER_PERSONAL_ACCESS_TOKEN=你的API密钥 qodercli --acp"
    }
  },
  "defaultAgent": "qoder",
  "defaultPermissions": "approve-all"
}
EOF

请务必将 你的API密钥 替换为你在 Qoder 官网获取的真实 Personal Access Token。

验证对接是否成功

首先检查 ACP 配置是否正确：

openclaw config get acp --raw

应返回如下结构的 JSON：

{
  "enabled": true,
  "dispatch": { "enabled": true },
  "backend": "acpx",
  "defaultAgent": "qoder",
  "allowedAgents": ["qoder"]
}

配置无误后，在你的聊天渠道（钉钉、飞书等）中尝试发起一个 ACP 会话：

/acp spawn qoder --mode persistent

如果返回了包含 agent:qoder:acp:xxx 格式会话密钥的成功消息，说明对接基本成功。

更自然的测试方式是直接提出需求：

用 qoder 开发一个 TODO list 应用，用 Next.js + TypeScript

OpenClaw 应能识别意图，并通过 ACP 将任务自动派发给 Qoder CLI 执行。

日常使用方式

对接完成后，你有两种主要方式在 OpenClaw 中向 Qoder 派发任务。

1. 使用命令

下表列出了常用的 ACP 命令：

命令	功能说明
/acp spawn qoder --mode persistent	创建一个持久会话，后续消息可继续发往此会话。
/acp spawn qoder --mode oneshot	执行一次性任务，不保留会话。
/acp status	查看当前会话状态和配置。
/acp steer 集中精力改测试	向当前运行的会话插入新指令，无需重启。
/acp model <模型id>	为当前会话临时切换模型。
/acp cancel	取消当前正在运行的任务。
/acp close	关闭当前会话，解除线程绑定。
/acp sessions	列出最近的 ACP 会话。

其中，steer 命令非常实用。当 Qoder 执行方向偏离时，你可以用 /acp steer 先别动 UI，把后端接口写完 来即时纠偏，无需中断重来。

2. 使用自然语言

ACP 支持自然语言触发。你可以在聊天中直接说：

• “在这个线程里开一个 Qoder 持久会话，帮我改测试。”
• “用 Qoder 跑一下这个需求，结果总结一下。”

OpenClaw 会自动识别意图，并通过 ACP 派发任务。如果提到了“在这个线程里”，它还会尝试将 Qoder 会话与当前聊天线程绑定。

线程绑定详解

线程绑定意味着将一个聊天线程与一个 Qoder 会话专属关联。绑定后，在该线程内的对话会自动派发给绑定的 Qoder 会话。

/acp spawn 命令的 --thread 参数控制绑定行为：

参数	行为
--thread auto	如果在聊天线程内使用，则绑定当前线程；否则新建一个线程。
--thread here	必须在聊天线程内使用，强制绑定当前线程，否则报错。
--thread off	不进行绑定，会话独立，只能通过 session key 访问。

如果在 Discord 中使用，还需启用相关配置：

openclaw config set session.threadBindings.enabled true
openclaw config set channels.discord.threadBindings.enabled true
openclaw config set channels.discord.threadBindings.spawnAcpSessions true
openclaw gateway restart

其他聊天渠道的配置类似，将 discord 替换为对应渠道名即可。当 --thread auto 或 --thread here 不生效时，首先检查这些开关是否已打开。

问题排查清单

如果对接或使用中遇到问题，请按以下顺序排查：

1. Gateway 服务是否运行？

openclaw gateway status

2. ACPX 插件是否加载？

openclaw plugins list | grep acpx

3. ACP 配置是否正确？

openclaw config get acp --raw

4. Qoder CLI 本身能否独立运行？

export QODER_PERSONAL_ACCESS_TOKEN=你的密钥
qodercli -p "hello" --max-turns 1

5. ACPX 配置文件是否正确？

cat ~/.acpx/config.json

6. 使用内置诊断命令：

/acp doctor

常见错误与原因对照表：

报错信息	可能原因
“ACP runtime backend is not configured”	ACPX 插件未安装或被禁用。
“ACP is disabled by policy”	acp.enabled 未设置为 true。
“ACP agent qoder is not allowed”	allowedAgents 列表中未包含 "qoder"。
“Unable to resolve session target”	会话密钥错误，可用 /acp sessions 查看有效会话。

总结

整个 ACP 对接流程清晰简单，核心就是三步：安装 ACPX 插件、启用并配置 ACP、设置 Qoder CLI 的启动方式。完成后，你的工作流将更加统一高效：在 OpenClaw 这个统一入口中提出需求，专业的编码任务通过 ACP 自动派发给 Qoder CLI 执行，结果直接返回当前对话。你无需切换工具或界面，即可享受专业 AI 编码助手的服务。

欢迎在 云栈社区 分享你的使用体验或遇到的问题，与其他开发者共同探讨 AI 代理与自动化部署的最佳实践。

相关资源

• OpenClaw 文档：https://docs.openclaw.ai
• Qoder 官网：https://qoder.com
• ACP 协议规范：https://agentclientprotocol.com
• Qoder CLI 快速入门：https://docs.qoder.com/cli/quick-start