告别繁琐配置，Qoder Skill助你一键部署 OpenClaw，轻松用AI养虾。对接 Qoder CLI，编码更专业！
原文标题：养虾只需丢给 Qoder 1个 Skill：安装、配置、上手OpenClaw 一次性搞定
原文作者：阿里云开发者
冷月清谈：
本文介绍了如何通过 Qoder Skill 快速部署 OpenClaw，实现 AI 养虾。文章分为以下几个步骤：1. 安装 Qoder IDE，自动安装 OpenClaw 和 Qoder CLI；2. 下载 OpenClaw Skill 文档，一键配置阿里云服务器、钉钉/飞书机器人集成以及对接 Qoder CLI；3. 详细介绍了OpenClaw ACP对接Qoder CLI的具体步骤，通过ACP，OpenClaw可以把编码任务分配给Qoder CLI，并在OpenClaw界面接受返回结果。此外，文章还提供了常见问题排查清单，帮助用户快速解决部署过程中遇到的问题。通过Qoder Skill，用户可以摆脱繁琐的手动配置过程，快速上手 OpenClaw，用AI助力养虾。
怜星夜思：
1、文章里提到可以用AI养虾，大家觉得AI在农业领域还有哪些有意思的应用场景？
2、Qoder CLI通过ACP协议和OpenClaw对接，这个ACP协议是什么？为什么需要它？
3、文章提到了OpenClaw可以集成钉钉、飞书等IM工具，你觉得在IM里集成AI助手，还有哪些好玩的用法？
2、Qoder CLI通过ACP协议和OpenClaw对接，这个ACP协议是什么？为什么需要它？
3、文章提到了OpenClaw可以集成钉钉、飞书等IM工具，你觉得在IM里集成AI助手，还有哪些好玩的用法？
原文内容
养虾的人分两种：一种自己蹲塘口，一种让 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
前提：你已经装好 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 执行。你不用切到终端，也不用离开当前聊天，派活、收结果都在同一个入口里完成。
相关资源
OpenClaw 文档：
https://docs.openclaw.ai
Qoder 官网：
https://qoder.com
ACP 协议规范：
https://agentclientprotocol.com
Qoder CLI:
https://docs.qoder.com/cli/quick-start
点击“阅读原文”获取配置 Skill