乐于分享
好东西不私藏

OpenClaw * ACP:用聊天工具驾驭你的编程智能体

OpenClaw * ACP:用聊天工具驾驭你的编程智能体

想象一个场景

你在飞书群里 @机器人说"用 Codex 帮我把这个 bug 修了",几分钟后它就提交了 PR。这不是幻想,这是 OpenClaw + ACP 正在做的事。

什么是 ACP?

ACP(Agent Client Protocol)是一个开放协议,让 AI 编程工具(如 Codex、Claude Code、Gemini CLI)可以通过标准化的接口被调度和控制。你可以把它理解为 AI 编程工具的"遥控器协议"。

OpenClaw 把 ACP 集成为自己的一个核心能力,让你在飞书、Discord、Telegram 等聊天工具里,直接驱动 Codex、Claude Code、Gemini CLI 等编程智能体干活。

核心架构:两种模式

模式一:ACP Agent(让编程工具给你打工)

OpenClaw 作为调度中心,启动和管理外部的编程智能体。你发消息给 OpenClaw,OpenClaw 把任务转交给 Codex 或 Claude Code 去执行,结果再返回给你。

这是最常用的模式——"在聊天工具里编程"。

模式二:ACP Bridge(让 IDE 连接 OpenClaw)

OpenClaw 作为 ACP 服务器,IDE(如 Zed 编辑器)通过 ACP 协议连接过来。这样你在 IDE 里就能调用 OpenClaw 的能力——搜索记忆、查日历、发消息,都行。

五分钟上手 ACP Agent

第一步:确认环境就绪

在聊天里发:/acp doctor

OpenClaw 会自动检查 ACP 后端(acpx)是否安装、版本是否匹配。新安装的 OpenClaw 默认已内置 acpx 插件,通常开箱即用。

第二步:启动一个 ACP 会话

最简单的方式——绑定当前对话:/acp spawn codex --bind here

这条命令的意思是:启动一个 Codex 会话,并且把当前聊天窗口绑定上去。之后你在这个聊天里发的消息,都会被路由给 Codex 处理。

你也可以选择用线程(Discord/Telegram):/acp spawn claude --thread auto

这会创建一个新线程,把 Claude Code 绑定到里面,保持主频道干净。

第三步:干活

绑定完成后,直接在聊天里描述你想做什么:

"帮我写一个 Python 脚本,监控这个目录下新增的图片文件,自动压缩到 80% 质量并移动到 output 文件夹"

Codex/Claude 就会在后端工作目录里开始编码,完成后把结果反馈给你。

第四步:管理会话

/acp status — 查看当前会话状态

/acp steer 加上日志输出 — 中途调整方向,不用重新开始

/acp model anthropic/claude-opus-4-6 — 切换模型

/acp close — 关闭会话

自然语言触发

除了用 /acp 命令,你也可以直接用自然语言:

• "用 Codex 帮我跑一下这个仓库的测试"

• "让 Claude Code 在线程里帮我重构这个模块"

• "用 Gemini CLI 分析一下这个项目的架构"

OpenClaw 会自动识别意图,选择 ACP 运行时来执行。

支持的编程智能体

目前 OpenClaw 通过 acpx 后端支持以下工具:

Codex(OpenAI)

Claude Code(Anthropic)

Gemini CLI(Google)

Cursor、Copilot、Pi、Qwen、Kimi

• 还有 openclaw、opencode、kiro、droid、iflow、kilocode 等

配置文件里设置允许的智能体列表:

{"acp": {"enabled": true, "backend": "acpx", "defaultAgent": "codex", "allowedAgents": ["codex", "claude", "gemini", "cursor"]}}

会话绑定:让上下文不丢失

ACP 最强大的特性之一是会话绑定。你可以把一个聊天频道、一个线程、甚至一个飞书群,永久绑定到某个编程智能体。

绑定后,这个频道里的所有消息都由 Codex 处理,而且它会记住上下文——你昨天让它改的代码,今天继续讨论,它都记得。

权限与安全

ACP 会话是在宿主机上运行的(非沙箱),所以权限控制很重要:

approve-all — 自动批准所有文件读写和命令执行(适合信任环境)

approve-reads — 只自动批准读取操作

deny-all — 拒绝所有权限提示

在生产环境建议用 approve-reads + nonInteractivePermissions: deny,这样遇到写操作会优雅降级而不是直接崩溃。

ACP vs 子智能体:什么时候用哪个?

OpenClaw 还有自己的子智能体(subagent)系统。怎么选?

用 ACP:需要 Codex、Claude Code 等专业编程工具,需要持久的会话绑定,需要跨工具链协作

用子智能体:轻量任务,OpenClaw 自己就能搞定,不需要外部工具

简单说:重度编程 → ACP,日常任务 → 子智能体。

IDE 集成

如果你用 Zed 编辑器,可以直接把 OpenClaw 作为 ACP 服务器接入。在 Zed 的设置里添加 OpenClaw ACP 作为自定义 agent server,就能在编辑器的 Agent 面板里直接和 OpenClaw 对话,调用它的全部能力。

四个典型使用场景

1. 远程代码审查

在手机上的飞书群里说:"让 Codex 审查一下 PR #42,重点关注安全问题"。回来电脑前,审查结果已经在聊天里了。

2. 持续编码对话

在 Discord 里绑定一个线程给 Claude Code,整天和它讨论架构设计。它记得所有上下文,就像一个不休息的结对编程搭档。

3. 多智能体协作

一个频道用 Codex 写代码,另一个频道用 Gemini CLI 做 code review。各司其职,互不干扰。

4. 断点续传

在笔记本上用 Codex 改了一半的代码,出门了。掏出手机在 Telegram 里让 OpenClaw 恢复同一个 Codex 会话,继续工作:/acp spawn codex --resume <session-id>

总结

OpenClaw 的 ACP 集成把"在聊天工具里编程"从概念变成了现实:

开箱即用:新版 OpenClaw 内置 acpx,/acp doctor 一键检查

自然交互:说人话就能调度 Codex、Claude Code 等工具

会话绑定:频道/线程级别的持久化上下文

多工具支持:十几个主流编程智能体一键切换

跨平台:飞书、Discord、Telegram、WhatsApp……哪儿都能用

OpenClaw 是开源项目,GitHub: github.com/openclaw/openclaw,文档: docs.openclaw.ai