ACPx plugin: OpenClaw ACP runtime with plugin-owned session and transport management
This page covers the ACPx plugin for the OpenClaw ACP runtime backend, which manages sessions and transport using its own plugin-owned approach. It is intended for developers integrating Pi native sessions.
Read this when
- You are installing, configuring, or auditing the acpx plugin
ACPx plugin
The OpenClaw ACP runtime backend manages sessions and transport using its own plugin-owned approach.
Distribution
- Package:
@openclaw/acpx - Install route: npm; ClawHub
Surface
skills
Pi native sessions
The included runtime automatically finds Pi's session store on the Gateway and any paired nodes. Found sessions show up under the Pi sessions-sidebar group, where you can browse transcripts in read-only mode using Pi's documented JSONL session format. The catalog respects project and global settings.json session directories, as well as PI_CODING_AGENT_DIR and PI_CODING_AGENT_SESSION_DIR. Relative paths are resolved from the directory that holds their settings.json file.
To turn off discovery, disable Pi Session Catalog under Config > Plugins > ACPX Runtime. This setting is on by default.