ACP Agents

ACP 是一种特别的“协议”，你可以把它想成是 OpenClaw 和外面那些聪明的“代码小助手”（比如 Codex, Claude Code）之间说好的悄悄话方式。这样，OpenClaw 就能请它们来帮忙干活啦。

什么时候用 ACP 呢？ 当你想要 OpenClaw 去请一个专门的、外部的“代码小助手”来工作时，就用 ACP。这就像你想请一个特别擅长搭积木的朋友来帮忙，而不是让 OpenClaw 自己动手。

怎么快速开始用呢？ 你可以直接跟 OpenClaw 说人话，比如：“在这里开一个持久的 Codex 会话，让它保持专注。” OpenClaw 听到后，就会自动去安排 ACP 小帮手了。

更具体的操作步骤（给想动手的大人看）： 如果你想用更直接的命令来控制，可以试试这些步骤：

1. 召唤一个小帮手会话：用命令 /acp spawn codex --mode persistent --thread auto。这就像说：“请一个叫 Codex 的小帮手来，让它一直待着，并自动和当前的聊天话题绑在一起。”
2. 在绑定的聊天话题里工作：之后，你在这个话题里发的消息，都会自动交给那个 Codex 小帮手处理。
3. 看看小帮手在干嘛：用 /acp status 命令，可以查看小帮手的状态和设置。
4. 调整小帮手的设置：如果需要，你可以用一些命令来调整，比如：
   • /acp model <提供商/模型名>：换一个小帮手用的“大脑”模型。
   • /acp permissions <配置文件>：调整小帮手能做哪些事情的权限。
   • /acp timeout <秒数>：设置小帮手思考的超时时间。
5. 轻轻推一下小帮手：如果小帮手正在干活，你可以用 /acp steer tighten logging and continue 这样的命令给它一些提示，但不会打断它原来的任务。
6. 停止工作：
   • 用 /acp cancel 可以停止小帮手当前正在做的这一步。
   • 用 /acp close 则是关闭整个会话，并解开和聊天话题的绑定。

一些重要的限制和要注意的地方：

• 和“小跟班”的区别：OpenClaw 自己也有“小跟班”（sub-agents）。简单说，想用外部专门的代码工具就选 ACP；想让 OpenClaw 自己派任务给内部的小跟班，就用 sub-agents。
• “沙盒”限制：ACP 小帮手目前是在“主机”上运行的，不在 OpenClaw 的“沙盒”（一个保护性的小院子）里。所以，如果你自己处在一个“沙盒”会话中，是无法召唤 ACP 小帮手的，系统会阻止并提示你错误。这时候你需要改用 runtime: "subagent" 来请 OpenClaw 自己的小跟班。
• 权限问题：因为 ACP 小帮手是自动运行的，没人能实时点击“批准”按钮，所以它的文件读写、运行命令的权限需要提前设置好。如果没设置对，它可能会因为权限问题而失败。通常需要在配置里把 permissionMode 设为 approve-all。
• 聊天话题绑定：这个功能很酷，可以把小帮手固定在一个聊天话题里。但并不是所有聊天渠道（比如 Discord, Telegram）都支持，需要额外打开一些设置开关才行。

怎么安装和设置呢？ 要让 ACP 工作，你需要先安装一个叫 acpx 的后端插件，就像给小帮手准备一个工作台。

1. 安装插件：在命令行里运行 openclaw plugins install acpx。
2. 启用插件：运行 openclaw config set plugins.entries.acpx.enabled true。
3. 检查健康：运行 /acp doctor 命令，看看小帮手的工作台是不是准备好了。

如果遇到问题怎么办？ 说明书最后有一个“问题排查”表格，像个小药箱。比如，如果看到错误说“ACP runtime backend is not configured”，那就是工作台（acpx插件）没装好，按照上面的安装步骤做就行。如果小帮手因为权限问题卡住，就去检查 permissionMode 的设置。