Files
openclaw/docs/plugins/reference/opencode.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

45 lines
1.4 KiB
Markdown

---
summary: "Adds OpenCode model provider support to OpenClaw."
read_when:
- You are installing, configuring, or auditing the opencode plugin
title: "OpenCode plugin"
---
# OpenCode plugin
Adds OpenCode model provider support to OpenClaw.
## Distribution
- Package: `@openclaw/opencode-provider`
- Install route: included in OpenClaw
## Surface
providers: `opencode`; contracts: `mediaUnderstandingProviders`
<!-- openclaw-plugin-reference:manual-start -->
## Native sessions
OpenClaw auto-detects the `opencode` CLI on the Gateway and paired nodes. Stored
sessions then appear in the **OpenCode** sessions-sidebar group, with transcript
browsing through the official `opencode --pure db ... --format json` and
`opencode --pure export` commands. Local rows also offer **Continue**, which
creates an OpenClaw session whose first turn resumes the native OpenCode session
through ACP. OpenCode retains the full server-side model context, 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.
The restricted environment and `--pure` mode prevent catalog browsing from
loading project plugins or inheriting unrelated Gateway credentials.
Turn **OpenCode Session Catalog** off under **Config > Plugins > OpenCode** to
disable discovery. It is enabled by default.
<!-- openclaw-plugin-reference:manual-end -->
## Related docs
- [opencode](/providers/opencode)