openclaw/docs/plugins/reference/acpx.md
Patrick Erichsen d6d7435f59
feat(plugins): default package installs to ClawHub (#173669)
* feat(plugins): default unprefixed packages to ClawHub

Use the shared source planner for CLI, chat, and assistant installs. Keep explicit npm and local sources, preserve canonical built-in shortcuts, and retain the selected registry in update and repair records.

Autoreview findings addressed:
- [P2] Preserve ClawHub provenance in search hints that match aliases
  Route scoped packages through ClawHub and add @latest to ambiguous unscoped search hints.
- [P2] Preserve usable search hints for scoped names with file suffixes
  Treat file-suffixed package names as registry specs, migrate source-selection tests, and retain npm in retry guidance.
- [P2] Update the remaining source-selection test expectations
  Treat file-suffixed package names as registry specs, migrate source-selection tests, and retain npm in retry guidance.
- [P2] Keep npm prerelease retry hints on npm
  Treat file-suffixed package names as registry specs, migrate source-selection tests, and retain npm in retry guidance.
- [P2] Restrict catalog shortcuts to canonical plugin IDs
  Restrict bare shortcuts to canonical IDs and retain npm in shared hook-pack prerelease guidance.
- [P2] Preserve npm in hook-pack prerelease guidance
  Restrict bare shortcuts to canonical IDs and retain npm in shared hook-pack prerelease guidance.

* docs(plugins): show ClawHub as the default install source

Update setup examples and generated inventory instructions to omit the ClawHub prefix. Document explicit npm selection and canonical plugin-ID shortcuts.

* fix(plugins): keep recovery tied to the selected source

* test(plugins): cover search commands and saved registry choices

* test(plugins): align pre-action recovery with selected sources

* test(plugins): prove source-bound recovery through the CLI

* fix(plugins): retain official identity during config recovery
2026-10-16 22:07:52 +00:00

1.9 KiB

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 reference

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

Distribution

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

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 OpenClaw imports the recent native history into the adopted session transcript. Very long transcripts import only their most recent 200 items using a 512 KiB serialized-item budget. 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.