本页内容

本页内容

代理协调

ACP 代理

Agent 客户端协议 (ACP) 会话让 OpenClaw 运行外部编码工具(Claude Code、Cursor、Copilot、Droid、OpenClaw ACP、 OpenCode、Gemini CLI 和其他支持的 acpx harness)通过 ACP 后端插件。 ACP 运行时拥有每个会话及其取消。

我该看哪个页面?

你想要 to... 用这个 笔记
在当前会话中绑定或控制Codex /codex bind, /codex threads 启用 codex 插件时的本机 Codex 应用程序服务器路径:绑定聊天回复、图像转发、model/fast/permissions、停止和转向。 ACP 是一个明确的后备
运行 Claude Code、Gemini CLI、显式 Codex ACP 或其他外部harness through OpenClaw 本页 聊天绑定会话、/acp spawn、sessions_spawn({ runtime: "acp" })、后台任务、运行时控件
将 OpenClaw 网关会话公开为编辑器或客户端的 ACP 服务器 openclaw acp 桥接模式:IDE/client 通过 stdio/WebSocket 与 OpenClaw 进行 ACP 通话
使用本地AI CLI(例如Claude Code)作为代理的模型运行时 CLI Backends 不是 ACP:仅通过 MCP 桥的网关工具,没有 ACP 控件,没有harness运行时

ACP 代理文档页面

此页是一个索引。 ACP 代理记录在七页上,每个读者作业一页。打开与您的任务匹配的页面。

页面 读它的时候
ACP 智能体快速入门 您正在安装 ACP 运行时插件或选择harness目标 ID。
ACP 代理操作员操作手册 您通过聊天运行 /acp,并且需要流程、生命周期和路由规则。
ACP 代理绑定 您正在绑定对话、线程或配置的 bindings[] 条目。
ACP 代理会话 您需要 sessions_spawn 参数或 --bind 和 --thread 模式。
ACP 代理发货模型 您正在调试完成交付、恢复或沙箱边界。
ACP代理控制 您需要 /acp 命令参考和运行时选项映射。
ACP代理故障排除 您遇到 ACP 错误消息,需要可能的原因并进行修复。

ACP 与子代理

当您需要外部harness运行时时,请使用 ACP。当启用 codex 插件时,使用 native Codex app-server 进行 Codex 对话 binding/control。当您想要 OpenClaw-native 委托运行时,请使用 sub-agents。

区域 ACP 会话 子代理运行
运行时 ACP 后端插件(例如 acpx) OpenClaw 原生子代理运行时
会话 key agent:<agentId>:acp:<uuid> agent:<agentId>:subagent:<uuid>
主要命令 /acp ... /subagents ...
生成工具 sessions_spawn,使用 runtime:"acp" sessions_spawn(默认运行时)

另见 子代理。

ACP 如何运行 Claude Code

对于 Claude Code 到 ACP,堆栈为:

  1. OpenClaw ACP 会话控制平面。
  2. 官方 @openclaw/acpx 运行时插件。
  3. Claude ACP 适配器。
  4. Claude-方runtime/session机械。

ACP Claude 是一个 harness 会话,具有 ACP 控件、会话恢复、后台任务跟踪和可选的 conversation/thread 绑定。

CLI 后端是一个单独的路径:本地 CLI 在模型运行时运行正常代理轮流,没有 ACP 控件。参见 CLI Backends。

对于运维人员,实用规则是:

  • 想要 /acp spawn、可绑定会话、运行时控制,或持久的 harness 工作? 使用 ACP。
  • 想要普通代理轮流通过本地CLI运行,例如Claude Code? 使用CLI后端。

acpx 运行器、插件设置和权限

有关 acpx 运行器配置(Claude Code/Codex/Gemini CLI 别名)、 plugin-tools 和 OpenClaw-tools MCP 桥接,以及 ACP 权限模式, 请参见 ACP agents - 设置。

各部分移动的地方

先前单页版本的每个部分标题都保留其锚点,因此现有链接(例如 /tools/acp-agents#persistent-channel-bindings)仍然可以解析。每个条目都指向现在保存内容的页面。

相关内容

本页有帮助吗?