Acpx Coding Default

Use direct acpx CLI via exec as the default coding execution path for Codex- and Claude-focused agents.

Use direct acpx CLI through exec for coding work.

Binary

Always prefer the plugin-local binary:

bash

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

Core rules

• acpx is invoked through exec; it is not a separate built-in tool.
• For coding, debugging, refactoring, test-running, and repo tasks, default to direct acpx.
• Always pass explicit --cwd.
• Prefer --format quiet unless verbose output is requested.
• Reuse named sessions when continued context is useful.
• If acpx fails, report the exact failing command and reason before falling back.
• If the task explicitly asks for ACP runtime thread/session behavior, use ACP runtime instead of this skill.

Adapter defaults

• Codex-focused agent -> codex
• Claude-focused agent -> claude

Templates

Codex one-shot

bash

cd "<repo>" && /opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx codex exec "<prompt>"

Claude one-shot

bash

cd "<repo>" && /opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx claude exec "<prompt>"

Codex session

bash

cd "<repo>" && /opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx codex sessions show <name> \
  || /opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx codex sessions new --name <name>

cd "<repo>" && /opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx codex -s <name> "<prompt>"

Claude session

bash

cd "<repo>" && /opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx claude sessions show <name> \
  || /opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx claude sessions new --name <name>

cd "<repo>" && /opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx claude -s <name> "<prompt>"

Failure handling

• NO_SESSION: create the named session, then retry once.
• Binary missing/version issue: check plugin-local binary first.
• Adapter/toolchain missing: report the exact missing command.
• Do not silently switch to another execution path and pretend acpx was used. eck plugin-local binary first.
• Adapter/toolchain missing: report the exact missing command.
• Do not silently switch to another execution path and pretend acpx was used.