本页内容
本页内容
代理协调
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,堆栈为:
- OpenClaw ACP 会话控制平面。
- 官方
@openclaw/acpx运行时插件。 - Claude ACP 适配器。
- 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)仍然可以解析。每个条目都指向现在保存内容的页面。
- 这个可以开箱即用吗?
- 首次运行陷阱
- 运行时先决条件
- 支持的harness目标
- 操作手册
- Spawn
- 工作
- 检查状态
- Tune
- 转向
- 停止
- 生命周期详细信息
- 原生 Codex 路由规则
- 模型/提供者/运行时选择备忘单
- ACP-路由自然语言触发器
- 绑定会话
- 心理模型
- 当前会话绑定
- 约束规则和排他性
- 线程绑定会话
- 螺纹支撑通道
- 持久通道绑定
- 绑定模型
bindings[].typebindings[].matchbindings[].agentIdbindings[].acp.modebindings[].acp.labelbindings[].acp.cwdbindings[].acp.backend- 每个代理的运行时默认值
- 示例
- 行为
- 开始 ACP 会话
- 来自
sessions_spawn - 来自
/acp命令 sessions_spawn参数taskruntimeagentIdthreadmodecwdlabelresumeSessionIdstreamTomodelthinking- Spawn 绑定和线程模式
--bind here|off--thread auto|here|off- 发货模型
- 交互式 ACP 会话
- 家长拥有的一次性 ACP 会话
sessions_send和 A2A 发货- 恢复现有会话
- 部署后冒烟测试
- 沙箱兼容性
- 会话目标解析
- 会话所有者和利用
- ACP 控制
- 运行时选项映射
- 故障排除
相关内容
- ACP 代理 - 设置
- 代理绑定
- Agent 发送
- CLI Backends
- Codex 运行环境
- Codex harness运行时
- 多代理沙箱工具
openclaw acp(桥接模式)- 子代理
- Steer — 主动运行转向和排队 ACP 后续操作
本页有帮助吗?