Stone Acpx
/install stone-acpx
acpx
Use acpx as the CLI transport for ACP coding clients.
Local policy for this machine
- OpenClaw ACP runtime uses a fixed plugin-local
acpxversion, notnpx acpx@latest. - Current pinned target:
0.3.0. - Prefer these configured ACP harness agents for coding work:
openai_codex_agent-> Codexclaude_code_agent-> Claude Codegoogle_gemini_agent-> Gemini CLI
- Gemini CLI must use its own default model on this machine; do not force deprecated model ids in ACP overrides.
- Use
npx acpx@latestonly for explicit manual experiments or upgrade checks, not as the default OpenClaw runtime backend.
Binary selection
For OpenClaw/runtime-integrated ACP work, prefer the plugin-local binary:
/opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx
Check the pinned version from the extension package:
node -e "console.log(require('/opt/homebrew/lib/node_modules/openclaw/extensions/acpx/package.json').dependencies.acpx)"
Common commands
acpx codex "fix the tests"
acpx claude "refactor auth"
acpx gemini exec "summarize this repo"
acpx codex sessions new --name backend
acpx codex sessions close backend
References
For the full upstream reference, read:
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install stone-acpx - After installation, invoke the skill by name or use
/stone-acpx - Provide required inputs per the skill's parameter spec and get structured output
What is Stone Acpx?
Use the acpx CLI to run coding agents over the Agent Client Protocol (ACP) instead of PTY scraping. Use when routing work to Codex, Claude Code, Gemini CLI,... It is an AI Agent Skill for Claude Code / OpenClaw, with 35 downloads so far.
How do I install Stone Acpx?
Run "/install stone-acpx" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Stone Acpx free?
Yes, Stone Acpx is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Stone Acpx support?
Stone Acpx is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Stone Acpx?
It is built and maintained by Kevin Stone (@chaoyang78); the current version is v1.0.0.