英文 ACP Agents

2026年4月5日约 17 分钟

原始链接：https://docs.openclaw.ai/tools/acp-agents
来源章节：5. 官方文档：工具、技能、插件与自动化
来源小节：无
抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/tools/acp-agents
抓取时间：2026-04-05 13:47:10
状态：ok

中文内容

ACP 特工 - OpenClaw

跳到主要内容

[OpenClaw主页！图片1：深色徽标！图片2：深色徽标](http://docs.openclaw.ai/)

图3：美国

英语

搜索...

⌘K

搜索...

导航

代理协调

ACP 代理

开始安装频道代理工具和插件模型平台网关和操作参考帮助

概述

工具和插件

插件

#####技能

自动化和任务

工具

apply_patch工具
网页浏览器
网络工具
顺便说一句附带问题
代码执行
差异
提升模式
执行工具
执行批准
[图像生成](http://docs.openclaw.ai/tools/image- Generation)
LLM任务
龙虾
工具循环检测
PDF工具
反应
思维水平

代理协调

在此页面上

ACP 代理
我想要哪个页面？
这可以开箱即用吗？
快速算子流程
[人类快速入门](http://docs.openclaw.ai/tools/acp-agents#quick-start-for- humans)
ACP 与子代理
ACP 如何运行克劳德代码
绑定会话
当前对话绑定
线程绑定会话
线程支持通道
通道特定设置
绑定模型
[伦蒂

我默认每个代理](http://docs.openclaw.ai/tools/acp-agents#runtime-defaults-per-agent)

ess 支持（当前）](http://docs.openclaw.ai/tools/acp-agents#acpx-harness-support-current)

代理协调

ACP 代理

Agent Client Protocol (ACP) 会话允许 OpenClaw 通过 ACP 后端插件运行外部编码工具（例如 Pi、Claude Code、Codex、Cursor、Copilot、OpenClaw ACP、OpenCode、Gemini CLI 和其他受支持的 ACPX 工具）。如果您以简单语言要求 OpenClaw “在 Codex 中运行此程序”或“在线程中启动 Claude Code”，OpenClaw 应路由该路径向 ACP 运行时（而不是本机子代理运行时）发出请求。每个 ACP 会话生成都作为后台任务进行跟踪。如果您希望 Codex 或 Claude Code 作为外部 MCP 客户端直接连接到现有 OpenClaw 通道对话，请使用 openclaw mcpserve 而不是 ACP。

我想要哪个页面？

附近有三个容易混淆的表面：

你想要……	使用这个	笔记
通过 OpenClaw	运行 Codex、Claude Code、Gemini CLI 或其他外部工具本页：ACP 代理	聊天绑定会话、`/acp spawn`、`sessions_spawn({ runtime: "acp" })`、后台任务、运行时控件
将 OpenClaw Gateway 会话公开为编辑器或客户端的 ACP 服务器	`openclaw acp`	桥接模式。 IDE/客户端通过 stdio/WebSocket 与 ACP 对话
重复使用本地 AI CLI 作为纯文本后备模型	CLI 后端	不是 ACP。没有 OpenClaw 工具、没有 ACP 控件、没有线束运行时

这可以开箱即用吗？

通常，是的。

全新安装现在默认启用捆绑的“acpx”运行时插件。
捆绑的“acpx”插件更喜欢其插件本地固定的“acpx”二进制文件。
启动时，OpenClaw 会探测该二进制文件并在需要时进行自我修复。
如果您想要快速检查准备情况，请从“/acp doctor”开始。

首次使用时仍可能发生什么情况：

第一次使用该线束时，可以根据需要使用“npx”获取目标线束适配器。
该线束的主机上仍然必须存在供应商身份验证。
如果主机没有 npm/网络访问权限，首次运行的适配器获取可能会失败，直到缓存预热或以其他方式安装适配器。

示例：

/acp spawn codex：OpenClaw 应该准备好引导 acpx，但 Codex ACP 适配器可能仍需要首次运行获取。
/acp spawn claude：Claude ACP 适配器的情况相同，加上该主机上的 Claude 端身份验证。

快速的操作流程

当您想要实用的“/acp”操作手册时，请使用此方法：

生成一个会话：
- /acp spawn codex --bind here
- /acp spawn codex --mode persist --thread auto
在绑定的对话或线程中工作（或显式定位该会话密钥）。
检查运行时状态：
- /acp状态
根据需要调整运行时选项：
- /acp model <提供者/模型>
- /acp 权限 <配置文件>
- /acp 超时 <秒>
微移活动会话而不替换上下文：
- /acp 引导收紧日志记录并继续

6.停止工作： * /acp cancel（停止当前回合），或者 * /acp close（关闭会话+删除绑定）

[](http://docs.openclaw.ai/tools/acp-agents#quick-start-for- humans)

人类快速入门

自然请求的示例： *“将此 Discord 频道绑定到 Codex。” *“在此处的线程中启动持久的 Codex 会话并保持专注。” *“将其作为一次性 Claude Code ACP 会话运行并总结结果。” *“将此 iMessage 聊天绑定到 Codex，并在同一工作区中进行后续跟进。” *“在线程中使用 Gemini CLI 执行此任务，然后在同一线程中保持后续操作。”

OpenClaw 应该做什么：

选择运行时：“acp”。
解析请求的线束目标（“agentId”，例如“codex”）。
如果请求当前会话绑定并且活动通道支持它，则将 ACP 会话绑定到该会话。
否则，如果请求线程绑定并且当前通道支持，则将 ACP 会话绑定到线程。
将后续绑定消息路由到同一 ACP 会话，直到失去焦点/关闭/过期。

ACP 与子代理

当您需要外部线束运行时时，请使用 ACP。当您想要 OpenClaw 本机委托运行时，请使用子代理。

面积	ACP 会议	子代理运行
运行时	ACP 后端插件（例如 acpx）	OpenClaw 本机子代理运行时
会话密钥	`代理：<agentId>:acp:<uuid>`	`代理：<agentId>：子代理：<uuid>`
主要命令	`/acp ...`	`/子代理 ...`
生成工具	`sessions_spawn` 与 `runtime:"acp"`	`sessions_spawn`（默认运行时）

另请参阅子代理。

ACP 如何运行 Claude Code

对于通过 ACP 的 Claude Code，堆栈为： 1.OpenClaw ACP会话控制平面 2. 捆绑 acpx 运行时插件 3.克劳德ACP适配器 4. Claude 端运行时/会话机制

重要区别：

ACP Claude 与直接的 claude-cli/... 后备运行时不同。
ACP Claude 是一个带有 ACP 控件、会话恢复、后台任务跟踪和可选对话/线程绑定的工具会话。
claude-cli/... 是纯文本本地 CLI 后端。请参阅 CLI 后端。

对于运营商来说，实际规则是：

想要“/acp spawn”、可绑定会话、运行时控件或持久性利用工作：使用 ACP
希望通过原始 CLI 进行简单的本地文本回退：使用 CLI 后端

绑定会话

当前对话绑定

当您希望当前对话成为持久的 ACP 工作区而不创建子线程时，请使用“/acp spawn --bind here”。行为：

OpenClaw 继续拥有通道传输、身份验证、安全性和交付。
当前对话固定到生成的 ACP 会话密钥。
该对话中的后续消息路由到同一 ACP 会话。
/new 和 /reset 重置相同的绑定 ACP 会话。
/acp close 关闭会话并删除当前对话绑定。

这在实践中意味着什么：

--bind here 保持相同的聊天界面。在 Discord 上，当前频道仍然是当前频道。
如果您正在生成新的工作，--bind here 仍然可以创建新的 ACP 会话。绑定将该会话附加到当前对话。
--bind here 本身不会创建子 Discord 线程或 Telegram 主题。
ACP 运行时仍然可以在磁盘上拥有自己的工作目录 (cwd) 或后端管理的工作区。该运行时工作区与聊天界面分开，并不意味着新的消息传递线程。
如果您生成到不同的 ACP 代理并且不传递 --cwd，则 OpenClaw 默认继承目标代理的工作区，而不是请求者的工作区。
如果继承的工作空间路径丢失（ENOENT/ENOTDIR），OpenClaw 会回退到后端默认 cwd，而不是默默地重用错误的树。
如果继承的工作空间存在但无法访问（例如EACCES），spawn返回真正的访问错误而不是删除cwd。

心理模型：

聊天界面：人们不断交谈的地方（Discord 频道、Telegram 主题、iMessage 聊天）
ACP 会话：持久的 Codex/Claude/Gemini 运行时状态 OpenClaw 路由到
子线程/主题：仅由“--thread ...”创建的可选额外消息传递表面
运行时工作区：harness 运行的文件系统位置（cwd、repo checkout、后端工作区）

示例：

/acp spawn codex --bind here：保留此聊天，生成或附加 Codex ACP 会话，并将未来的消息路由到此处
/acp spawn codex --thread auto：OpenClaw 可能会创建一个子线程/主题并在那里绑定 ACP 会话
/acp spawn codex --bind here --cwd /workspace/repo：与上面相同的聊天绑定，但 Codex 在 /workspace/repo 中运行

当前对话绑定支持：

宣传当前对话绑定支持的聊天/消息通道可以通过共享对话绑定路径使用“--bind here”。
具有自定义线程/主题语义的通道仍然可以在同一共享接口后面提供特定于通道的规范化。
--bind here 始终意味着“将当前对话绑定到位”。
通用当前对话绑定使用共享 OpenClaw 绑定存储，并在正常网关重启后继续存在。

注意事项：

--bind here 和 --thread ... 在 /acp spawn 上是互斥的。
在 Discord 上，“--bind here”将当前通道或线程绑定到位。仅当 OpenClaw 需要为“--thread auto|here”创建子线程时才需要“spawnAcpSessions”。
如果活动通道未公开当前对话 ACP 绑定，OpenClaw 将返回一条明确的不受支持的消息。 *“恢复”和“新会话”问题是 ACP 会话问题，而不是频道问题。您可以重用或替换运行时状态，而无需更改当前的聊天界面。

线程绑定会话

当为通道适配器启用线程绑定时，ACP 会话可以绑定到线程：

OpenClaw 将线程绑定到目标 ACP 会话。
该线程中的后续消息路由到绑定的 ACP 会话。
ACP 输出被传递回同一线程。
取消焦点/关闭/存档/空闲超时或最大年龄到期会删除绑定。

线程绑定支持是特定于适配器的。如果活动通道适配器不支持线程绑定，OpenClaw 将返回明确的不支持/不可用消息。线程绑定 ACP 所需的功能标志：

acp.enabled=true
acp.dispatch.enabled 默认开启（设置 false 暂停 ACP 调度）
启用通道适配器 ACP 线程生成标志（特定于适配器） *不和谐：channels.discord.threadBindings.spawnAcpSessions = true
- 电报：channels.telegram.threadBindings.spawnAcpSessions=true

螺纹支持通道

任何公开会话/线程绑定功能的通道适配器。
当前内置支持：
- 不和谐线程/频道
- Telegram 主题（群组/超级群组中的论坛主题和 DM 主题）
插件通道可以通过相同的绑定接口添加支持。

通道特定设置

对于非临时工作流程，请在顶级“绑定[]”条目中配置持久 ACP 绑定。

绑定模型

bindings[].type="acp" 标记持久 ACP 会话绑定。
bindings[].match 标识目标对话：
- 不和谐频道或线程： match.channel="discord" + match.peer.id="<channelOrThreadId>"
- Telegram 论坛主题: match.channel="telegram" + match.peer.id="<chatId>:topic:<topicId>"
- BlueBubbles DM/群组聊天： match.channel="bluebubbles" + match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>" 优先选择 chat_id:* 或 chat_identifier:* 以获得稳定的群组绑定。
- iMessage DM/群聊： match.channel="imessage" + match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>" 优先选择 chat_id:* 以获得稳定的群组绑定。
bindings[].agentId 是拥有的 OpenClaw 代理 ID。
可选的 ACP 覆盖 bindings[].acp 下的活动： *“模式”（“持久”或“一次性”）
- 标签
- cwd
- 后端

每个代理的运行时默认值

使用 agents.list[].runtime 为每个代理定义一次 ACP 默认值：

agents.list[].runtime.type="acp"
agents.list[].runtime.acp.agent （线束 ID，例如 codex 或 claude）
agents.list[].runtime.acp.backend
agents.list[].runtime.acp.mode
agents.list[].runtime.acp.cwd

覆盖 ACP 绑定会话的优先级：

绑定[].acp.*
agents.list[].runtime.acp.*
全局 ACP 默认值（例如 acp.backend）

示例：

{
  代理商：{
    列表：[
      {
        id：“法典”，
        运行时间：{
          类型：“acp”，
          acp：{
            代理：“法典”，
            后端：“acpx”，
            模式：“持久”，
            cwd：“/工作空间/openclaw”，
          },
        },
      },
      {
        id：“克劳德”，
        运行时间：{
          类型：“acp”，
          acp: { 代理: "claude", 后端: "acpx", 模式: "持久" },
        },
      },
    ],
  },
  绑定：[
    {
      类型：“acp”，
      代理 ID：“法典”，
      匹配：{
        频道：“不和谐”，
        账户ID：“默认”，
        对等：{ kind：“频道”，id：“2222222222222222222” }，
      },
      acp: { 标签: "codex-main" },
    },
    {
      类型：“acp”，
      代理 ID：“克劳德”，
      匹配：{
        频道：“电报”，
        账户ID：“默认”，
        对等：{ kind：“组”，id：“-1001234567890：主题：42”}，
      },
      acp: { cwd: "/workspace/repo-b" },
    },
    {
      类型：“路线”，
      代理ID：“主要”，
      匹配：{频道：“discord”，accountId：“默认”}，
    },
    {
      类型：“路线”，
      代理ID：“主要”，
      匹配：{频道：“电报”，accountId：“默认”}，
    },
  ],
  渠道：

{
    不和谐：{
      行会：{
        “111111111111111111”：{
          频道：{
            "222222222222222222": { requireMention: false },
          },
        },
      },
    },
    电报：{
      组：{
        “-1001234567890”：{
          主题: { "42": { requireMention: false } },
        },
      },
    },
  },
}

行为：

OpenClaw 确保配置的 ACP 会话在使用前存在。
该通道或主题中的消息路由到配置的 ACP 会话。
在绑定对话中，“/new”和“/reset”重置相同的 ACP 会话密钥。
临时运行时绑定（例如由线程焦点流创建的）仍然适用于存在的情况。
对于没有显式“cwd”的跨代理 ACP 生成，OpenClaw 会从代理配置继承目标代理工作区。
缺少继承的工作空间路径回退到后端默认cwd；非缺失访问失败表现为生成错误。

启动 ACP 会话（接口）

来自“sessions_spawn”

使用 runtime: "acp" 从代理轮次或工具调用启动 ACP 会话。

{
  "task": "打开存储库并总结失败的测试",
  “运行时”：“acp”，
  “agentId”：“法典”，
  “线程”：正确，
  “模式”：“会话”
}

注意事项：

runtime 默认为 subagent，因此为 ACP 会话显式设置 runtime: "acp"。
如果省略 agentId，OpenClaw 在配置时使用 acp.defaultAgent。
mode: "session" 需要 thread: true 来保持持久绑定会话。

接口详情：

task（必需）：发送到 ACP 会话的初始提示。
runtime（ACP 必需）：必须是 "acp"。
agentId（可选）：ACP 目标线束 ID。如果设置，则回退到 acp.defaultAgent。
thread （可选，默认为 false）：请求线程绑定流（如果支持）。
mode（可选）：run（一次性）或session（持久）。
- 默认为“运行”
- 如果省略 thread: true 并且模式，OpenClaw 可能默认为每个运行时路径的持久行为
- mode: "session" 需要 thread: true
cwd （可选）：请求的运行时工作目录（由后端/运行时策略验证）。如果省略，ACP 生成会在配置时继承目标代理工作区；缺少继承的路径会回退到后端默认值，同时返回实际访问错误。
label（可选）：会话/横幅文本中使用的面向操作员的标签。
resumeSessionId（可选）：恢复现有 ACP 会话而不是创建新会话。代理通过“会话/负载”重播其对话历史记录。需要运行时：“acp”。
streamTo（可选）："parent" 将初始 ACP 运行进度摘要作为系统事件流回请求者会话。
- 如果可用，接受的响应包括指向会话范围 JSONL 日志的“streamLogPath”（“.acp-stream.jsonl”），您可以跟踪完整的中继历史记录。

恢复现有会话

使用 resumeSessionId 继续之前的 ACP 会话，而不是重新开始。代理通过“会话/加载”重播其对话历史记录，因此它可以获取之前发生的内容的完整上下文。

{
  "task": "从我们上次停下的地方继续——修复剩余的测试失败",
  “运行时”：“acp”，
  “agentId”：“法典”，
  "resumeSessionId": "<上一个会话 ID>"
}

常见用例：

将 Codex 会话从笔记本电脑转移到手机上 — 告诉您的代理从您上次中断的地方继续
继续您在 CLI 中以交互方式启动的编码会话，现在通过您的代理进行无头操作
恢复因网关重启或空闲超时而中断的工作

注意事项：

resumeSessionId 需要 runtime: "acp" — 如果与子代理运行时一起使用，则返回错误。
resumeSessionId 恢复上游 ACP 会话历史记录； thread 和 mode 仍然通常适用于您正在创建的新 OpenClaw 会话，因此 mode: "session" 仍然需要 thread: true。
目标代理必须支持 session/load (Codex 和 Claude Code 都支持)。
如果未找到会话 ID，则生成会失败并出现明显错误 — 不会静默回退到新会话。

操作员烟雾测试

当您想要快速实时检查 ACP Spawn 是否真正端到端地工作而不仅仅是通过单元测试时，请在网关部署后使用此选项。推荐的网关：

验证部署的网关版本/在目标主机上提交。
确认部署的源在“src/gateway/sessions-patch.ts”（“subagent:* 或 acp:* 会话”）中包含 ACP 沿袭接受。
打开与实时代理的临时 ACPX 桥接会话（例如“jpclawhq”上的“razor(main)”）。
要求该代理使用以下命令调用 sessions_spawn：
- 运行时：“acp”
- agentId: "codex"
- 模式：“运行”
- 任务：准确回复 LIVE-ACP-SPAWN-OK
验证代理报告：
- 接受=是
- 一个真正的childSessionKey
- 没有验证器错误
清理临时 ACPX 桥接会话。

对实时代理的提示示例：

现在使用sessions_spawn工具，运行时：“acp”，agentId：“codex”，模式：“run”。
将任务设置为：“准确回复 LIVE-ACP-SPAWN-OK”。
然后仅报告：accepted=<yes/no>; childSessionKey=<值或无>;错误=<精确文本或无>。

注意事项：

除非您有意测试线程绑定的持久 ACP 会话，否则请将此冒烟测试保持在“模式：“运行””状态。
基本门不需要 streamTo: "parent"。该路径取决于请求者/会话功能，并且是单独的集成检查。
将线程绑定“模式：“会话””测试视为来自真实 Discord 线程或 Telegram 主题的第二个、更丰富的集成过程。

沙箱兼容性

ACP 会话当前在主机运行时上运行，而不是在 OpenClaw 沙箱内运行。当前限制：

如果请求者会话已沙箱化，则 sessions_spawn({ runtime: "acp" }) 和 /acp spawn 的 ACP 生成都会被阻止。
- 错误：沙盒会话无法生成 ACP 会话，因为 runtime="acp" 在主机上运行。从沙盒会话中使用runtime=“subagent”。
带有 runtime: "acp" 的 sessions_spawn 不支持 sandbox: "require"。
- 错误：runtime="acp" 不支持 sessions_spawn sandbox="require"，因为 ACP 会话在沙箱外部运行。使用runtime =“subagent”或sandbox =“inherit”。

当您需要沙箱强制执行时，请使用“runtime:“subagent””。

来自“/acp”命令

需要时，使用“/acp spawn”从聊天中进行显式操作员控制。

/acp spawn codex --mode persist --thread auto
/acp spawn codex --mode oneshot --thread off
/acp spawn codex --bind here
/acp 在此处生成 codex --thread

关键标志：

--mode persist|oneshot
--在此绑定|关闭
--thread auto|此处|关闭
--cwd <绝对路径>
--label <名称>

请参阅斜线命令。

会话目标解析

大多数“/acp”操作接受可选的会话目标（“session-key”、“session-id”或“session-label”）。解析顺序：

显式目标参数（或“/acp steer”的“--session”）
- 尝试按键
- 然后是UUID形状的会话id
- 然后标记
当前线程绑定（如果此会话/线程绑定到 ACP 会话）
当前请求者会话回退

当前会话绑定和线程绑定都参与步骤 2。如果没有目标解析，OpenClaw 将返回一个明确的错误（“无法解析会话目标：...”）。

生成绑定模式

/acp spawn 支持 --bind here|off。

模式	行为
`这里`	将当前活动对话绑定到位；如果没有活动，则失败。
`关闭`	不要创建当前对话绑定。

注意事项：

--bind here 是“让此频道或聊天受 Codex 支持”的最简单的操作路径。
--bind here 不会创建子线程。
--bind here 仅适用于公开当前对话绑定支持的通道。
--bind 和 --thread 不能在同一个 /acp spawn 调用中组合使用。

生成线程模式

/acp spawn 支持 --thread auto|here|off。

模式	行为
`自动`	在活动线程中：绑定该线程。在线程之外：创建/绑定子线程（如果支持）。
`这里`	需要当前活动线程；如果不合一则失败。
`关闭`	没有绑定。会话开始时未绑定。

注意事项：

在非线程绑定表面上，默认行为实际上是“关闭”。
线程绑定spawn需要通道策略支持： *不和谐：channels.discord.threadBindings.spawnAcpSessions = true
- 电报：channels.telegram.threadBindings.spawnAcpSessions=true
当您想要固定当前对话而不创建子线程时，请使用“--bind here”。

ACP 控制

可用的命令系列：

/acp 生成
/acp 取消
/acp 转向
/acp 关闭
/acp状态
/acp 设置模式
/acp 设置
/acp cwd
/acp 权限
/acp 超时
/acp模型
/acp 重置选项
/acp 会话
/acp医生
/acp 安装

“/acp status”显示有效的运行时选项，以及运行时级别和后端级别会话标识符（如果可用）。某些控件依赖于后端功能。如果后端不支持某个控件，OpenClaw 将返回一个明确的不支持控件错误。

ACP 命令手册

命令	它有什么作用	示例
`/acp 生成`	创建ACP会话；可选的当前绑定或线程绑定。	`/acp spawn codex --bind here --cwd /repo`
`/acp 取消`	取消目标会话的飞行中转弯。	`/acp 取消代理:codex:acp:<uuid>`
`/acp 转向`	向正在运行的会话发送转向指令。	`/acp steer --session support 收件箱优先考虑失败的测试`
`/acp 关闭`	关闭会话并取消绑定线程目标。	`/acp 关闭`
`/acp 状态`	显示后端、模式、状态、运行时选项、功能。	`/acp 状态`
`/acp 设置模式`	设置目标会话的运行时模式。	`/acp 设置模式计划`
`/acp 集`	通用运行时配置选项写入。	`/acp 设置模型 openai/gpt-5.4`
`/acp cwd`	设置运行时工作目录覆盖。	`/acp cwd /Users/user/Projects/repo`
`/acp 权限`	设置审批策略配置文件。	`/acp 权限严格`
`/acp 超时`	设置运行时超时（秒）。	`/acp 超时 120`
`/acp 模型`	设置运行时模型覆盖。	`/acp 模型人类/claude-opus-4-6`
`/acp 重置选项`	删除会话运行时选项覆盖。	`/acp 重置选项`
`/acp 会话`	列表

“/acpsessions”读取当前绑定或请求者会话的存储。接受“session-key”、“session-id”或“session-label”令牌的命令通过网关会话发现解析目标，包括自定义的每个代理“session.store”根。

运行时选项映射

/acp 有方便的命令和通用的 setter。等效操作：

/acp model <id> 映射到运行时配置键 model。
/acp 权限 <profile> 映射到运行时配置键 approval_policy。
/acp timeout <秒> 映射到运行时配置键 timeout。
/acp cwd <path> 直接更新运行时 cwd 覆盖。
/acp set <key> <value> 是通用路径。
- 特殊情况：key=cwd 使用 cwd 覆盖路径。
/acp reset-options 清除目标会话的所有运行时覆盖。

acpx 线束支持（当前）

当前 acpx 内置线束别名： *“克劳德”

法典 *“副驾驶”
cursor （光标 CLI：cursor-agent acp） *机器人 *双子座
iflow
千码 *基米 *基罗 *张开爪
开放代码
pi
qwen

当 OpenClaw 使用 acpx 后端时，首选“agentId”的这些值，除非您的 acpx 配置定义了自定义代理别名。如果您的本地 Cursor 安装仍然将 ACP 公开为“agent acp”，请覆盖 acpx 配置中的“cursor”代理命令，而不是更改内置默认值。直接 acpx CLI 使用也可以通过“--agent ”定位任意适配器，但原始逃生舱口是 acpx CLI 功能（不是正常的 OpenClaw“agentId”路径）。

所需配置

核心 ACP 基线：

{
  acp：{
    启用：真，
    // 可选。默认为 true；设置 false 以暂停 ACP 调度，同时保留 /acp 控制。
    调度：{启用：true}，
    后端：“acpx”，
    默认代理：“codex”，
    允许的代理：[
      “克劳德”，
      “法典”，
      “副驾驶”，
      “光标”，
      “机器人”，
      “双子座”，
      “流动”，
      “千码”，
      “基米”，
      “基罗”，
      “张开爪”，
      “开放代码”，
      “pi”，
      “qwen”，
    ],
    最大并发会话数：8，
    流：{
      合并空闲数：300，
      最大块字符数：1200，
    },
    运行时间：{
      ttl分钟：120，
    },
  },
}

线程绑定配置是特定于通道适配器的。不和谐的示例：

{
  会话：{
    线程绑定：{
      启用：真，
      空闲时间：2

> 说明：该页面原文较长，已翻译前半部分；完整原文请查看原始链接。

英文 ACP Agents

中文内容

ACP 特工 - OpenClaw

概述

插件

自动化和任务

工具

代理协调

ACP 代理

[](http://docs.openclaw.ai/tools/acp-agents#quick-start-for- humans)

On this page

英文 ACP Agents

中文内容

ACP 特工 - OpenClaw

概述

插件

自动化和任务

工具

代理协调

ACP 代理

[](http://docs.openclaw.ai/tools/acp-agents#quick-start-for- humans)

On this page

英文 ACP Agents

中文内容

ACP 特工 - OpenClaw

概述

插件

自动化和任务

工具

代理协调

ACP 代理

[​](http://docs.openclaw.ai/tools/acp-agents#quick-start-for- humans)

On this page

英文 ACP Agents

中文内容

ACP 特工 - OpenClaw

概述

插件

自动化和任务

工具

代理协调

ACP 代理

[​](http://docs.openclaw.ai/tools/acp-agents#quick-start-for- humans)

On this page

[](http://docs.openclaw.ai/tools/acp-agents#quick-start-for- humans)

[](http://docs.openclaw.ai/tools/acp-agents#quick-start-for- humans)