mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-03 18:51:38 +00:00
e19841c725
* 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
47 lines
1.6 KiB
Markdown
47 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 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.
|
|
|
|
<!-- openclaw-plugin-reference:manual-end -->
|
|
|
|
## Related docs
|
|
|
|
- [acpx](/tools/acp-agents-setup)
|