mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-02 23:01:35 +00:00
9dfb2a1318
* fix(plugins): import adopted catalog history into the OpenClaw transcript Import native Pi and OpenCode history when a catalog session is adopted so the OpenClaw transcript reflects the full conversation immediately. Mark imported user rows with mirrorOrigin because they are transcript mirrors, not new external turns. This preserves watcher deduplication and prevents adopted history from being reported as fresh upstream input. * refactor(plugins): split catalog history importer Keep the session catalog contract module leaf-like by moving transcript mutation into a dedicated runtime module. This breaks the registry-to-transcript import cycle while preserving the Plugin SDK entrypoint and importer behavior.
49 lines
1.6 KiB
Markdown
49 lines
1.6 KiB
Markdown
---
|
|
summary: "OpenClaw ACP runtime backend with plugin-owned session and transport management."
|
|
read_when:
|
|
- You are installing, configuring, or auditing the acpx plugin
|
|
title: "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
|
|
|
|
<!-- openclaw-plugin-reference:manual-start -->
|
|
|
|
## 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.
|
|
|
|
<!-- openclaw-plugin-reference:manual-end -->
|
|
|
|
## Related docs
|
|
|
|
- [acpx](/tools/acp-agents-setup)
|