OpenCode: Use Zen and Go Catalogs with OpenClaw

This page explains how to use OpenCode's Zen and Go catalogs through OpenClaw. It covers setup, API key configuration, and model verification for both catalogs.

Read this when

  • You want OpenCode-hosted model access
  • You want to pick between the Zen and Go catalogs

OpenCode makes two hosted catalogs available through OpenClaw:

CatalogPrefixRuntime provider
Zenopencode/...opencode
Goopencode-go/...opencode-go

A single OpenCode API key (OPENCODE_API_KEY, also called OPENCODE_ZEN_API_KEY) works with both catalogs. OpenClaw keeps the runtime provider identifiers separate so upstream per-model routing functions correctly, yet onboarding and documentation treat them as a single OpenCode configuration.

Getting started

Zen catalog

Ideal for: the curated OpenCode multi-model proxy (Claude, GPT, Gemini, GLM, DeepSeek, Kimi, MiniMax, Qwen).

Run onboarding

openclaw onboard --auth-choice opencode-zen

Alternatively, provide the key directly:

openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"

Set a Zen model as the default

openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6"

Verify models are available

openclaw models list --provider opencode

Go catalog

Ideal for: the OpenCode-hosted Kimi, GLM, MiniMax, Qwen, and DeepSeek models.

Run onboarding

openclaw onboard --auth-choice opencode-go

Or pass the key directly:

openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"

Set a Go model as the default

openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.6"

Verify models are available

openclaw models list --provider opencode-go

Config example

{
  env: { OPENCODE_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

Built-in catalogs

Zen

PropertyValue
Runtime provideropencode
Example modelsopencode/claude-opus-4-6, opencode/gpt-5.5, opencode/gemini-3.1-pro, opencode/glm-5.2

Run openclaw models list --provider opencode to retrieve the full live list, which contains free-tier entries like opencode/big-pickle and opencode/deepseek-v4-flash-free.

Go

PropertyValue
Runtime provideropencode-go
Example modelsopencode-go/kimi-k2.6, opencode-go/glm-5, opencode-go/minimax-m2.5

Visit OpenCode Go for the complete Go model table.

Advanced configuration

API key aliases

OPENCODE_ZEN_API_KEY works as an alternative name for OPENCODE_API_KEY.

Shared credentials

Providing one OpenCode key during setup stores credentials for both runtime providers. There is no need to onboard each catalog individually.

Getting an API key

Create an OpenCode account and obtain an API key at opencode.ai/auth. The OpenCode dashboard controls billing and catalog availability.

Gemini replay behavior

OpenCode references backed by Gemini stay on the proxy-Gemini path, so OpenClaw applies Gemini thought-signature cleaning there without activating native Gemini replay validation or bootstrap rewrites.

Non-Gemini replay behavior

Non-Gemini OpenCode references follow the minimal OpenAI-compatible replay policy.