ACP Agents

ACP 会话让 OpenClaw 通过 ACP 后端插件运行外部“编码 Harness”（例如 Codex、Claude Code、Gemini CLI）。

ACP vs 子智能体

ACP：由 ACP 后端（插件/runtime）驱动的会话
子智能体：OpenClaw 原生的委派运行

启动 ACP 会话（工具接口）

使用 sessions_spawn 且显式设置 runtime: "acp"：

{
  "task": "Open the repo and summarize failing tests",
  "runtime": "acp",
  "agentId": "codex",
  "thread": true,
  "mode": "session"
}

基线配置示例

{
  acp: {
    enabled: true,
    dispatch: { enabled: true },
    backend: "acpx",
    defaultAgent: "codex",
    allowedAgents: ["pi", "claude", "codex", "opencode", "gemini"],
    maxConcurrentSessions: 8,
    runtime: { ttlMinutes: 120 }
  }
}

安装后端插件（acpx）

openclaw plugins install @openclaw/acpx
openclaw config set plugins.entries.acpx.enabled true

验证：

/acp doctor