ACP Bug Report Bundle: Claude session-mode fails, exec-mode works

Date: 2026-03-02 (America/New_York)
Host: Theo’s Mac mini
OpenClaw: gateway healthy/running (LaunchAgent)
acpx version: 0.1.13

Summary

Claude via ACP fails in persistent/session mode with RUNTIME: Internal error, while Claude in one-shot exec mode succeeds.

This explains OpenClaw ACP behavior:

• sessions_spawn(runtime:"acp", agentId:"claude") gets accepted but fails turn execution (ACP_TURN_FAILED / internal error).
• agentId:"codex" works.

Environment snapshot

openclaw status

Relevant: gateway reachable and stable; LaunchAgent running.

/opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx --version

Output:

0.1.13

Reproduction (minimal)

Use this binary:

ACPX=/opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx

1) Claude exec mode (works)

$ACPX claude exec "reply with exactly acpx-claude-ok"

Output:

acpx-claude-ok

[done] end_turn

2) Claude persistent named session mode (fails)

S='agent:claude:acp:manual-debug-1'
$ACPX claude sessions show "$S" >/dev/null 2>&1 || $ACPX claude sessions new --name "$S" >/dev/null
$ACPX claude -s "$S" "reply with exactly manual-session-ok"

Output:

[error] RUNTIME: Internal error
[acpx] created session agent:claude:acp:manual-debug-1 (c133f1ca-8336-4edc-b1d0-72167f70c59a)
[acpx] agent: claude
[acpx] cwd: /Users/theowoodin/.openclaw/workspace
[acpx] session agent:claude:acp:manual-debug-1 (c133f1ca-8336-4edc-b1d0-72167f70c59a) · /Users/theowoodin/.openclaw/workspace · agent needs reconnect

Exit code: 1

3) Claude persistent default-cwd session mode (fails)

$ACPX claude sessions new >/dev/null
$ACPX claude "reply with exactly default-session-ok"

Output:

[error] RUNTIME: Internal error
[acpx] created session cwd (5477457d-dbd8-4a63-9cb1-acf8f6da1cfc)
[acpx] agent: claude
[acpx] cwd: /Users/theowoodin/.openclaw/workspace
[acpx] session cwd (5477457d-dbd8-4a63-9cb1-acf8f6da1cfc) · /Users/theowoodin/.openclaw/workspace · agent needs reconnect

Exit code: 1

4) Control test: Codex persistent session mode (works)

S='agent:codex:acp:manual-debug-1'
$ACPX codex sessions show "$S" >/dev/null 2>&1 || $ACPX codex sessions new --name "$S" >/dev/null
$ACPX codex -s "$S" "reply with exactly manual-session-ok"

Output:

[acpx] created session agent:codex:acp:manual-debug-1 (019cae93-17d1-7033-a527-53cd7650a958)
[acpx] agent: codex
[acpx] cwd: /Users/theowoodin/.openclaw/workspace
[acpx] session agent:codex:acp:manual-debug-1 (...) · /Users/theowoodin/.openclaw/workspace · agent needs reconnect
[thinking] **Confirming precise manual response**
manual-session-ok

[done] end_turn

OpenClaw ACP corroboration logs

From /tmp/openclaw/openclaw-2026-03-02.log:

... acp startup identity reconcile (renderer=v1): checked=11 resolved=0 failed=11
... errorMessage=AcpRuntimeError: Internal error runId=d008a6bf-dc0e-4ef0-b1a9-10d14fb15310 error=... code=ACP_TURN_FAILED ...
... errorMessage=AcpRuntimeError: Internal error runId=96397249-7c9b-4bf2-ac11-3e87eb11dcdd error=... code=ACP_TURN_FAILED ...

Impact

• OpenClaw ACP sessions for agentId:"claude" are unusable in normal session flow.
• agentId:"codex" remains viable workaround.
• Claude is usable only via one-shot acpx claude exec at present.

Current workaround

• Route ACP tasks to agentId:"codex".
• Use acpx claude exec only for one-shot Claude calls (non-session).

Suspected area

• @zed-industries/claude-agent-acp adapter session-mode lifecycle (resume/reconnect/session state), not generic acpx transport.

Ask to maintainers

Please investigate why Claude adapter fails in persistent/session prompts while one-shot exec succeeds in the same environment and binary version.