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

53 lines
2 KiB
Markdown

---
summary: "Adds OpenCode model provider support to OpenClaw."
read_when:
- You are installing, configuring, or auditing the opencode plugin
title: "OpenCode plugin reference"
---
<!-- Generated file. Do not edit by hand.
Run `pnpm plugins:inventory:gen` to rebuild it. Hand-written text survives only
between the openclaw-plugin-reference:manual-start and
openclaw-plugin-reference:manual-end comment markers. -->
Adds OpenCode model provider support to OpenClaw.
## Distribution
- Package: `@openclaw/opencode-provider`
- Install route: npm or ClawHub: `@openclaw/opencode-provider`
## 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 CLI. OpenCode v1 uses `--pure db` and `--pure export`;
v2 uses `api session.list` and `session export` with a private standalone server.
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 prevents catalog browsing from inheriting unrelated
Gateway credentials. OpenCode v1 uses `--pure`; v2 uses an empty temporary config
directory with project configuration disabled to avoid loading user plugins.
Failed CLI calls produce an `opencode/session-catalog` warning in Gateway logs.
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)