Files
openclaw/docs/plugins/reference/acpx.md
Peter Steinberger 05fb55eb7b feat: discover OpenCode and Pi sessions on paired nodes (#106941)
* feat(sessions): add opencode and pi catalogs

* fix(sessions): satisfy catalog lint

* fix(sessions): validate pi storage paths

* fix(sessions): index growing pi transcripts

* refactor(sessions): split pi path resolution

* docs(sessions): refresh catalog map

* refactor(sessions): privatize pi catalog internals

* fix(sessions): validate node catalog payloads

* fix(sessions): harden external catalog discovery

* fix(sessions): normalize catalog transcript data

* refactor(gateway): keep node scope gate compact

* fix(opencode): reject option-like session ids

* fix(sessions): align external id validation
2026-07-13 21:45:53 -07:00

1.0 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; session catalog: pi

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 read-only transcript browsing from Pi's documented JSONL session format. 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.