Stone Acpx

该 Skill 说明如何用 acpx 作为 ACP 编码客户端的 CLI 传输层，向 Codex、Claude Code、Gemini CLI 等代理发起编码任务并管理会话；同时记录本机 OpenClaw 使用固定 acpx 版本和插件内二进制路径的策略。

chaoyang78

热度 16.02

最近更新 2026-05-21 19:56:56

分类：开发依赖：代码执行应用场景：代码生成 / 调试排错 / 工作流 / 摘要总结

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add stone-acpx

Metadata

name: acpx
description: 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, Pi, OpenCode, or other ACP-compatible coding clients; when inspecting acpx commands, flags, sessions, or workflows; or when maintaining a fixed acpx runtime version for OpenClaw ACP agents.

acpx

Use acpx as the CLI transport for ACP coding clients.

Local policy for this machine

OpenClaw ACP runtime uses a fixed plugin-local acpx version, not npx acpx@latest.
Current pinned target: 0.3.0.
Prefer these configured ACP harness agents for coding work:
- openai_codex_agent -> Codex
- claude_code_agent -> Claude Code
- google_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@latest only 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: