Files
openclaw/docs/plugins/reference/opencode.md
Peter Steinberger 9dfb2a1318 fix: show native history in adopted Pi and OpenCode sessions (#114040)
* 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.
2026-07-26 02:09:48 -04:00

1.6 KiB

summary, read_when, title
summary read_when title
Adds OpenCode model provider support to OpenClaw.
You are installing, configuring, or auditing the opencode plugin
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

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. OpenClaw also 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.

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.