养虾只需丢给 Qoder 1个 Skill：安装、配置、上手OpenClaw 一次性搞定

发布日期：2026-03-11 18:19:26 浏览次数： 2979

作者：阿里云开发者

微信搜一搜，关注“阿里云开发者”

养虾的人分两种：一种自己蹲塘口，一种让 AI 蹲。有人花三天折腾服务器环境、配钉钉机器人、对接各种协议，虾还没养起来人先累趴了。而另一种人，把一个 Skill 文件丢给 Qoder，说了句"帮我装"，然后去泡了杯茶。茶还没泡好，虾塘已经跑起来了。

本文就是写给第二种人的。准确说，是写给你的 Qoder 看的。请直接把本文转发给你的Qoder，让它照着做就行，你负责池塘捞鱼：

第一步：下载安装 Qoder

安装一个 Qoder IDE，它会帮你完成 Open Claw 和 Qoder CLI 的安装、配置。

第一步：访问 Qoder 官网，用邮箱注册账号；

第二步：验证邮箱，激活账号，领取 300 个新注册用户 Credits；

第二步：安装 Open Claw（如已安装直接跳到第三步）

配置机器人、对接Qoder CLI

下载这个 Skill 文档丢给 Qoder，即可完成在阿里云服务器上安装 OpenClaw、配置钉钉或飞书机器人集成，并对接 Qoder CLI 的完整指南。适用于想在云服务器上部署 OpenClaw 并通过钉钉或飞书等 IM 使用 AI 助手的用户，以及需要进行代码开发的开发者。

Skills地址：

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

直接把这个 Skill 的 md 发给 Qoder 即可，接下来一步步跟着 Qoder 完成所有的安装流程吧！

提示：完成以上2步即可，教程环节已经全部完成，已有很多以下内容为给纯手工安装爱好者的详细教程。

第三步：把 Qoder CLI 接进你的 Open Claw

ACP 对接：打通 OpenClaw 与 Qoder 的协作通道

OpenClaw 装好了，你拿它当个人和工作的统一入口：消息、任务、协作都在钉钉、飞书里过，一个地方看全局。但写代码不一样，你希望交给专业的 Agentic coding 工具来做，而不是让大管家自己硬上。Qoder CLI 就是干这个的，能写代码、改项目、管工作区，专长明确。

问题来了：你不想离开 OpenClaw 的对话去单独开终端。你希望大管家来派活儿，你说需求，它把编码任务派给 Qoder，Qoder 在背后执行，结果回到当前对话。这样你始终待在一个入口里，专业的事由专业工具干。

ACP（Agent Client Protocol）就是这条「派活通道」。对接好之后，你在 OpenClaw 里说一句「用 Qoder 帮我实现这个需求」，大管家把任务路由给 Qoder CLI，执行完的结果直接回到聊天。下面把对接过程从头到尾走一遍。

ACP 是什么

ACP 全称 Agent Client Protocol，是 OpenClaw 用来对接「外部专业编码环境」的协议层。一头连着 OpenClaw 的调度（你的大管家），另一头连着 Qoder CLI 这类专门做 agentic coding 的工具。大管家不亲自写代码，而是通过 ACP 把编码任务派出去，谁接单、谁执行、结果回哪，都在这条通道里完成。

ACP 和 OpenClaw 自带的 Sub-Agents 分工不同：

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

简单记：要让大管家给 Qoder 派活儿，用 ACP；要在体系内多代理协作，用 Sub-Agents。

三步对接 Qoder CLI

再说一次：不是写给你看的，请把全文直接复制丢给你的 🦞

小龙虾机器人与Qoder配合完成财务报表开发：

localhost:3001 — 个人财务管理：

手机上也能验收完整的个人财务管理界面

前提：你已经装好 OpenClaw 并在跑（openclaw gateway status 显示正常），打算把 Qoder CLI 接进来当「被派活」的专业编码端。手上需要有一个 Qoder API Key（从 qoder.com 官网的 Settings → API Keys 里拿）。

Step 1 装 ACPX 插件

ACPX 是 OpenClaw 的 ACP 后端实现。没有它，ACP 协议跑不起来。

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

装完验证一下：

openclaw plugins list | grep acpx

看到这行就对了：

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

Step 2 打开 ACP 的开关

ACP 有好几个开关要一起打开，漏一个都不行。

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 全局开关、打开消息调度、设 Qoder 为默认 Agent、把 Qoder 加到白名单。最后重启 Gateway 让配置生效。

allowedAgents 是白名单，这里只放 "qoder"，表示只允许通过 ACP 调用 Qoder CLI。

Step 3 配置 Qoder CLI

先装 CLI：

npm install -g @qoder-ai/qodercli

然后创建 acpx 的配置文件，告诉它 Qoder 怎么启动：

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密钥 换成你自己的 Personal Access Token。这个 Token 在 qoder.com 的 Settings → API Keys 页面可以拿到。

验证对接成功

先看配置对不对：

openclaw config get acp --raw

输出应该长这样：

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

配置没问题的话，去你的聊天渠道（飞书、钉钉、Discord 都行）试一下：

/acp spawn qoder --mode persistent

如果返回了会话创建成功的消息，并且显示了类似 agent:qoder:acp:xxx 的 session key，说明对接完成了。

更直接的测试：直接用自然语言。

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

OpenClaw 会识别到你要把任务派给 Qoder，自动走 ACP 通道把请求发过去。

日常怎么用

对接好之后，你在大管家（OpenClaw）里派活给 Qoder，有两种方式：打命令和说人话。

打命令

常用的就这几个：

命令	干什么的
`/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，把后端接口写完 就行。

说人话

ACP 本身就支持自然语言触发。你在聊天里说：

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

OpenClaw 会识别出你要把活儿派给 Qoder，走 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 不生效的时候，第一件事就是来查这些开关有没有打开。备注：钉钉渠道配置估计有难度，可尝试其他 IM ，已反馈给钉钉同学优化中。

排查清单

对接出了问题，按这个顺序查：

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"`	session key 写错了，用 `/acp sessions` 看一下

对接完之后

整个对接过程不复杂。三步走完，五分钟左右：装 ACPX 插件、打开 ACP 开关、配好 Qoder CLI 的启动命令。之后你在 OpenClaw 里说一句「用 Qoder 帮我写个脚本」，大管家把活儿派给 Qoder，结果回到当前对话。

这样你的动线就统一了：OpenClaw 继续当生活和工作的大管家，编码这类专业活交给 Qoder CLI 执行。你不用切到终端，也不用离开当前聊天，派活、收结果都在同一个入口里完成。

53AI，企业落地大模型首选服务商

产品：场景落地咨询+大模型应用平台+行业解决方案

承诺：免费POC验证，效果达标后再合作。零风险落地应用大模型，已交付160+中大型企业