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:
| Catalog | Prefix | Runtime provider |
|---|---|---|
| Zen | opencode/... | opencode |
| Go | opencode-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
| Property | Value |
|---|---|
| Runtime provider | opencode |
| Example models | opencode/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
| Property | Value |
|---|---|
| Runtime provider | opencode-go |
| Example models | opencode-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.
Related
-
OpenCode Go, Complete Go catalog reference.
-
Model selection, Choosing providers, model refs, and failover behavior.
-
Configuration reference, Full config reference for agents, models, and providers.