Files
openclaw/docs/plugins/reference/acpx.md
Peter Steinberger e19841c725 feat: continue Pi and OpenCode sessions from the session catalog (#113718)
* feat(plugins): add acpSessionBinding seam for ACP session adoption

* feat(acpx,opencode): adopt existing Pi and OpenCode sessions from the catalog

* fix(ci): satisfy dead-code and temp-path guards

* docs(acpx): record why pi-acp session-root resolution stays strict
2026-07-25 08:35:47 -07:00

1.6 KiB

summary, read_when, title
summary read_when title
OpenClaw ACP runtime backend with plugin-owned session and transport management.
You are installing, configuring, or auditing the acpx plugin
ACPx plugin

ACPx plugin

OpenClaw ACP runtime backend with plugin-owned session and transport management.

Distribution

  • Package: @openclaw/acpx
  • Install route: npm; ClawHub

Surface

skills

Pi native sessions

The bundled runtime auto-detects Pi's session store on the Gateway and paired nodes. Stored sessions appear in the Pi sessions-sidebar group, with transcript browsing from Pi's documented JSONL session format. Local rows also offer Continue, which creates an OpenClaw session whose first turn resumes the native Pi session through ACP. Pi retains the full model context from its session file, and the catalog viewer continues to show that history. The new OpenClaw transcript starts empty and records only subsequent turns. Paired-node rows remain view-only. Custom session directories outside the store scanned by pi-acp remain browse-only because the adapter cannot resume those files by id.

The catalog honors project and global settings.json session directories plus PI_CODING_AGENT_DIR and PI_CODING_AGENT_SESSION_DIR. Relative paths resolve from the directory containing their settings.json file.

Turn Pi Session Catalog off under Config > Plugins > ACPX Runtime to disable discovery. It is enabled by default.