@tangta789/openclaw-xtmux
Thin OpenClaw plugin shell for the xtmux ACP harness. It does not implement ACP itself; it provides openclaw xtmux setup / openclaw xtmux status and the xtmux_setup / xtmux_status tools.
Install
From ClawHub
openclaw plugins install @tangta789/openclaw-xtmux
openclaw xtmux setup
openclaw xtmux status
The package bundles the ACP adapter. xtmux setup stages it into ~/.local/share/xtmux/adapter (XTMUX_HOME overrides), runs --check (building the vendored tmux on first use), and writes the acpx alias as python3 <staged>/agent.py --log /tmp/xtemux.log.
From a checkout
cd ~/xtmux/packages/openclaw-plugin
npm pack --pack-destination /tmp
openclaw plugins install /tmp/tangta789-openclaw-xtmux-0.1.3.tgz --force
openclaw xtmux setup
openclaw plugins pack refuses this plugin (it resolves the bundled adapter relative to the module); npm pack keeps the package layout intact. Local tarballs are not ClawHub-reviewed and show as provenance-invalid; they still load.
Without the plugin
The plugin is a convenience only; the acpx alias can be written directly:
openclaw config set plugins.entries.acpx.config.agents.xtmux \
"{\"command\":\"$HOME/xtmux/packages/xtmux-acp/xtmux_acp/agent.py\",\"args\":[\"--log\",\"/tmp/xtemux.log\"]}" \
--strict-json
Verify
openclaw xtmux status # prints the adapter command, runs `<adapter> --help`, shows the acpx alias
Then spawn a run from an ACP-capable agent and check /tmp/xtemux.log for client=acpx and a res#… ok line. Full verification steps: see the repository README.
Adapter resolution order: adapterPath config → XTMUX_ACP env → staged bundled copy in $XTMUX_HOME/adapter → xtmux-acp on PATH. Use the config/env override when you want a pipx or release install instead of the bundled copy.
Publish
npm i -g clawhub
clawhub login
clawhub package publish tangta789/openclaw-xtmux --dry-run
clawhub package publish tangta789/openclaw-xtmux
npm publish
Scope
- This plugin is an installation/status shell, not an ACP runtime backend.
- It does not bypass OpenClaw's ACP admission policy.
runtime:"acp"is refused when the requester's inherited deny includesapply_patch/edit/write/process.
