ACPx Plugin: ACP Runtime Backend for OpenClaw
Learn how the ACPx plugin gives OpenClaw plugins full control over session and transport handling, including Pi native session integration. Ideal for developers building or extending OpenClaw plugins.
Read this when
- You are installing, configuring, or auditing the acpx plugin
ACPx plugin
The ACP runtime backend for OpenClaw gives plugins full control over session and transport handling.
Distribution
- Package:
@openclaw/acpx - Install route: npm; ClawHub
Surface
skills
Pi native sessions
Pi's session store on the Gateway and paired nodes is picked up automatically by the bundled runtime. Sessions that have been stored show up in the Pi sessions-sidebar group, and transcript browsing relies on Pi's documented JSONL session format. A Continue option appears on local rows as well, which launches an OpenClaw session where the first turn picks up the native Pi session through ACP. The full model context stays with Pi inside its session file, while OpenClaw pulls the recent native history into the adopted session transcript. For transcripts that run very long, only the newest 200 entries are imported, capped by a 512 KiB serialized-item budget. Rows from paired nodes are restricted to viewing only. Custom session directories that sit outside the store scanned by pi-acp can only be browsed, not resumed, since the adapter cannot locate those files by id.
Project and global settings.json session directories are honored by the catalog, along with PI_CODING_AGENT_DIR and PI_CODING_AGENT_SESSION_DIR. When paths are relative, they resolve from the folder that holds the corresponding settings.json file.
Discovery can be turned off by switching Pi Session Catalog off under Config > Plugins > ACPX Runtime. On by default.