OpenCode plugin for OpenClaw: model provider support

This page describes the OpenCode plugin that enables OpenClaw to use OpenCode as a model provider. It covers distribution, surface, native session discovery, and configuration for developers and administrators.

Read this when

  • You are installing, configuring, or auditing the opencode plugin

OpenCode plugin

Enables OpenClaw to support OpenCode as a model provider.

Distribution

  • Package: @openclaw/opencode-provider
  • Install route: bundled with OpenClaw

Surface

providers: opencode; contracts: mediaUnderstandingProviders

Native sessions

On the Gateway and its paired nodes, the opencode command-line tool is detected automatically by OpenClaw. Any saved sessions are listed under the OpenCode group in the sessions sidebar, where transcripts can be browsed in read-only mode using the official opencode --pure db ... --format json and opencode --pure export commands. Project plugins are not loaded during catalog browsing, and unrelated Gateway credentials are not inherited, thanks to the restricted environment and --pure mode.

To turn off discovery, go to Config > Plugins > OpenCode and disable OpenCode Session Catalog. This feature is on by default.