ACP 智能体
Agent Client Protocol (ACP) 会话让 OpenClaw 可以通过 ACP 后端插件运行外部编码工具（Claude Code、Cursor、Copilot、Droid、 OpenClaw ACP、OpenCode、Gemini CLI 以及其他受支持的 acpx 工具）。ACP 运行时拥有每个会话及其取消操作。
Note
ACP 是外部工具路径，不是默认的 Codex 路径。 原生
Codex app-server 插件拥有 /codex ... 控制项和默认的
openai/gpt-* 嵌入式运行时，用于智能体回合。ACP 拥有 /acp ... 控制项
以及 sessions_spawn({ runtime: "acp" }) 会话。
要让 Codex 或 Claude Code 作为外部 MCP 客户端直接连接到
现有的 OpenClaw 频道对话，请使用
openclaw mcp serve，而不是 ACP。
我想找哪个页面？¶
| 你想…… | 使用此页面 | 备注 |
|---|---|---|
| 在当前对话中绑定或控制 Codex | /codex bind、/codex threads |
启用 codex 插件时的原生 Codex app-server 路径：绑定聊天回复、图片转发、模型/快速/权限、停止和转向。ACP 是显式回退方案 |
| 通过 OpenClaw 运行 Claude Code、Gemini CLI、显式 Codex ACP 或其他外部工具 | 本页面 | 绑定聊天的会话、/acp spawn、sessions_spawn({ runtime: "acp" })、后台任务、运行时控制 |
| 将 OpenClaw Gateway 会话 作为 ACP 服务器暴露给编辑器或客户端 | openclaw acp |
桥接模式：IDE/客户端通过 stdio/WebSocket 与 OpenClaw 进行 ACP 通信 |
| 将本地 AI CLI 复用为纯文本回退模型 | CLI 后端 | 不是 ACP：没有 OpenClaw 工具、没有 ACP 控制项、没有工具运行时 |
ACP 智能体文档页面¶
本页面是一个索引。ACP 智能体文档分为七个页面，每个页面对应一种读者角色。 打开与你任务匹配的页面。
| 页面 | 阅读时机 |
|---|---|
| ACP 智能体快速入门 | 你正在安装 ACP 运行时插件或选择工具目标 id。 |
| ACP 智能体运维手册 | 你从聊天中运行 /acp，需要了解流程、生命周期和路由规则。 |
| ACP 智能体绑定 | 你正在绑定对话、线程或配置的 bindings[] 条目。 |
| ACP 智能体会话 | 你需要 sessions_spawn 参数或 --bind 和 --thread 模式。 |
| ACP 智能体交付模型 | 你正在调试完成交付、恢复或沙箱边界。 |
| ACP 智能体控制项 | 你需要 /acp 命令参考和运行时选项映射。 |
| ACP 智能体故障排查 | 你遇到 ACP 错误消息，需要了解可能的原因和修复方法。 |
ACP 与子智能体对比¶
当你需要外部工具运行时，请使用 ACP。当 codex 插件
启用时，请使用原生 Codex app-server 进行 Codex 对话绑定/控制。当你需要 OpenClaw 原生的委派运行时，请使用子智能体。
| 领域 | ACP 会话 | 子智能体运行 |
|---|---|---|
| 运行时 | ACP 后端插件（例如 acpx） | OpenClaw 原生子智能体运行时 |
| 会话键 | agent:<agentId>:acp:<uuid> |
agent:<agentId>:subagent:<uuid> |
| 主要命令 | /acp ... |
/subagents ... |
| 生成工具 | 使用 runtime:"acp" 的 sessions_spawn |
sessions_spawn（默认运行时） |
另请参阅子智能体。
ACP 如何运行 Claude Code¶
对于通过 ACP 使用 Claude Code，技术栈如下：
- OpenClaw ACP 会话控制平面。
- 官方
@openclaw/acpx运行时插件。 - Claude ACP 适配器。
- Claude 侧运行时/会话机制。
ACP Claude 是一个工具会话，具有 ACP 控制项、会话恢复、 后台任务跟踪以及可选的对话/线程绑定。
CLI 后端是独立的纯文本本地回退运行时——请参阅 CLI 后端。
对于运维人员，实际操作规则是：
- 想要
/acp spawn、可绑定会话、运行时控制项或持久工具工作？ 使用 ACP。 - 想要通过原始 CLI 进行简单的本地文本回退？ 使用 CLI 后端。
acpx 工具、插件设置和权限¶
有关 acpx 工具配置（Claude Code / Codex / Gemini CLI 别名）、 插件工具和 OpenClaw 工具 MCP 桥接以及 ACP 权限模式， 请参阅ACP 智能体 - 设置。
每个章节的迁移位置¶
旧单页版本中的每个章节标题都保留了其锚点，
因此现有链接（如 /tools/acp-agents#persistent-channel-bindings）仍然可以解析。
每个条目都指向当前承载该内容的页面。
- 开箱即用吗？
- 首次运行注意事项
- 运行时前提条件
- 支持的 harness 目标
- 操作员运行手册
- 生成
- 工作
- 检查状态
- 调优
- 引导
- 停止
- 生命周期详情
- 原生 Codex 路由规则
- 模型 / 提供商 / 运行时选择速查表
- ACP 路由自然语言触发器
- 绑定会话
- 心智模型
- 当前对话绑定
- 绑定规则与排他性
- 线程绑定会话
- 支持线程的通道
- 持久通道绑定
- 绑定模型
bindings[].typebindings[].matchbindings[].agentIdbindings[].acp.modebindings[].acp.labelbindings[].acp.cwdbindings[].acp.backend- 每个代理的运行时默认值
- 示例
- 行为
- 启动 ACP 会话
- 来自
sessions_spawn - 来自
/acp命令 sessions_spawn参数taskruntimeagentIdthreadmodecwdlabelresumeSessionIdstreamTomodelthinking- 生成绑定与线程模式
--bind here|off--thread auto|here|off- 交付模型
- 交互式 ACP 会话
- 父级拥有的一次性 ACP 会话
sessions_send与 A2A 交付- 恢复现有会话
- 部署后冒烟测试
- 沙箱兼容性
- 会话目标解析
- 会话所有者与 harness
- ACP 控制
- 运行时选项映射
- 故障排除
相关¶
- ACP 代理 - 设置
- 代理绑定
- 代理发送
- CLI 后端
- Codex 测试框架
- Codex 测试框架运行时
- 多代理沙箱工具
openclaw acp（桥接模式）- 子代理
- 引导 — 活动运行引导和已排队的 ACP 后续操作
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw