想象一个场景
你在飞书群里 @机器人说"用 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
夜雨聆风