ACP Agents

ACP sessions let OpenClaw run external “coding harness” runtimes (for example Codex, Claude Code, Gemini CLI) via an ACP backend plugin.

ACP vs sub-agents

ACP sessions run in an ACP backend (plugin/runtime).
Sub-agents run as OpenClaw-native delegated runs.

Start an ACP session (tool interface)

Use sessions_spawn with runtime: "acp":

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

Required config (baseline)

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

Plugin setup (acpx backend)

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

Then verify:

/acp doctor