English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Providers

OpenCode

OpenCode exposes two hosted catalogs in OpenClaw:

Catalog Prefix Runtime provider
Zen opencode/... opencode
Go opencode-go/... opencode-go

Both catalogs share one OpenCode API key (OPENCODE_API_KEY, alias OPENCODE_ZEN_API_KEY). OpenClaw keeps the runtime provider ids split so upstream per-model routing stays correct, but onboarding and docs treat them as one OpenCode setup.

Getting started

Zen catalog

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

  • Run onboarding

    bash
    openclaw onboard --auth-choice opencode-zen

    Or pass the key directly:

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

  • Set a Zen model as the default

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

  • Verify models are available

    bash
    openclaw models list --provider opencode

    • Go catalog

    Best for: the OpenCode-hosted Kimi, GLM, MiniMax, Qwen, and DeepSeek lineup.

  • Run onboarding

    bash
    openclaw onboard --auth-choice opencode-go

    Or pass the key directly:

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

  • Set a Go model as the default

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

  • Verify models are available

    bash
    openclaw models list --provider opencode-go

    • Config example

    json5
    {  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 for the full current list, which also includes free-tier rows such as 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

    See OpenCode Go for the full Go model table.

    Advanced configuration

    API key aliases

    OPENCODE_ZEN_API_KEY is also accepted as an alias for OPENCODE_API_KEY.

    Shared credentials

    Entering one OpenCode key during setup stores credentials for both runtime providers. You do not need to onboard each catalog separately.

    Getting an API key

    Create an OpenCode account and generate an API key at opencode.ai/auth. Billing and catalog availability are managed from the OpenCode dashboard.

    Gemini replay behavior

    Gemini-backed OpenCode refs stay on the proxy-Gemini path, so OpenClaw keeps Gemini thought-signature sanitation there without enabling native Gemini replay validation or bootstrap rewrites.

    Non-Gemini replay behavior

    Non-Gemini OpenCode refs keep the minimal OpenAI-compatible replay policy.

    OpenCode Go

    Full Go catalog reference.
    Model selection

    Choosing providers, model refs, and failover behavior.
    Configuration reference

    Full config reference for agents, models, and providers.
    Was this useful?
    On this page

    On this page