openclaw/docs/providers/opencode.md at main

mirror of https://github.com/openclaw/openclaw.git synced 2026-03-12 07:20:45 +00:00

Files

Luke 7761e7626f Providers: add Opencode Go support (#42313 )

* feat(providers): add opencode-go provider support and onboarding

* Onboard: unify OpenCode auth handling openclaw#42313 thanks @ImLukeF

* Docs: merge OpenCode Zen and Go docs openclaw#42313 thanks @ImLukeF

* Update CHANGELOG.md

---------

Co-authored-by: Ubuntu <ubuntu@vps-90352893.vps.ovh.ca>
Co-authored-by: Vincent Koc <vincentkoc@ieee.org>

2026-03-11 01:31:06 -04:00

1.6 KiB

Raw Permalink Blame History

summary, read_when, title

summary

read_when

title

Use OpenCode Zen and Go catalogs with OpenClaw

You want OpenCode-hosted model access

You want to pick between the Zen and Go catalogs

OpenCode

OpenCode exposes two hosted catalogs in OpenClaw:

opencode/... for the Zen catalog
opencode-go/... for the Go catalog

Both catalogs use the same OpenCode 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.

CLI setup

Zen catalog

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

Go catalog

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

Config snippet

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

Catalogs

Zen

Runtime provider: opencode
Example models: opencode/claude-opus-4-6, opencode/gpt-5.2, opencode/gemini-3-pro
Best when you want the curated OpenCode multi-model proxy

Go

Runtime provider: opencode-go
Example models: opencode-go/kimi-k2.5, opencode-go/glm-5, opencode-go/minimax-m2.5
Best when you want the OpenCode-hosted Kimi/GLM/MiniMax lineup

Notes

OPENCODE_ZEN_API_KEY is also supported.
Entering one OpenCode key during onboarding stores credentials for both runtime providers.
You sign in to OpenCode, add billing details, and copy your API key.
Billing and catalog availability are managed from the OpenCode dashboard.

1.6 KiB Raw Permalink Blame History