ACP agents — setup | Fivey Can Read OpenClaw

先讲这一页到底在解决什么

ACP 机器人朋友s — setup：它会替你伸哪只手

ACP 机器人朋友s — setup 不是名词卡片，而是一只会伸出来帮忙的手。你要看清它什么时候出手、抓进去什么、递回来什么，还有每个参数到底像哪颗按钮。原文最响的一记鼓点，其实是：For the overview, operator runbook, and concepts, see ACP 机器人朋友s.。

原文共 15 节，先看 Start Here 路径：/tools/acp-agents-setup 查看官方原文

第一站

先确认你走的是 ACP/acpx 这条路

如果你只是用 OpenClaw 原生运行时，不一定需要这页。这里主要服务 ACP/acpx route，也就是让 Codex、Claude Code、Copilot、Cursor 这类 harness 接进来。

核心开关

acp.enabled 像总电闸，dispatch.enabled 像是否真的派单，backend: "acpx" 像指定走 acpx 后门。

agentId

内置别名包括 claude、codex、copilot、cursor。像给不同外部工人做工牌。

别混页面

原生 Codex app-server runtime 看 /plugins/codex-harness；模型 provider 和 API key 看 provider 页面。

一句话

这页不是 ACP 概念课，而是 ACP/acpx 真正落地时的接线图。

第二站

插件像发动机，bridge 像工具传送带

打包安装会使用官方 @openclaw/acpx runtime plugin。装好并启用以后，ACP harness 才能稳定开工。

安装 acpx 插件

openclaw plugins install @openclaw/acpx 像把专用发动机装进机房。

plugin tools bridge

打开 pluginToolsMcpBridge 后，ACP agent 才能通过桥看到 OpenClaw 插件注册的工具。

openClawToolsMcpBridge

这是另一条桥，给内置 OpenClaw 工具用，例如让 ACP agent 调 selected built-in tools。

timeoutSeconds

有些 harness 启动慢，可以把 acpx runtime 操作超时从默认 120 秒调高。

第三站

权限配置要当成“无人值守时怎么办”来理解

ACP sessions 通常没有 TTY，没法弹出一个人来点批准或拒绝。所以权限策略必须提前说清楚。

permissionMode

决定 harness agent 哪些操作可以不用现场问人。它像工人的长期门禁等级。

nonInteractivePermissions

决定如果本来该弹审批、但现场没人能点时怎么办。常见稳妥做法是失败，而不是偷偷放行。

和 exec approvals 分开

ACPX harness 权限不是 OpenClaw exec approvals，也不是某个 CLI vendor 的 bypass flag。别把三把钥匙混成一把。

改完要重启

插件配置、probe agent、timeout、权限这些设置改完后，通常要重启 Gateway 才算换上新规则。

最后总结

把 ACP setup 压成一句话

它是 ACP/acpx 的落地清单：开 ACP，装 acpx，按需打开工具桥，提前设好非交互权限，再重启检查。