Providers 导读

OpenCode 两个目录共用一个 API Key,但运行时 provider 是分开的

OpenCode 提供 Zen 和 Go 两个目录,分别对应 opencode 和 opencode-go 两个运行时 provider,但共用同一个 API Key。配置时只需设置一次 OPENCODE_API_KEY,然后通过模型前缀(opencode/ 或 opencode-go/)区分路由。最容易搞错的是:虽然 onboarding 和文档把两者当一套处理,但 OpenClaw 内部用 provider id 分开,所以模型列表和默认模型配置时要写对前缀。

先讲这一页到底在解决什么

OpenCode 两个目录共用一个 API Key,但运行时 provider 是分开的

OpenCode 提供 Zen 和 Go 两个目录,分别对应 opencode 和 opencode-go 两个运行时 provider,但共用同一个 API Key。配置时只需设置一次 OPENCODE_API_KEY,然后通过模型前缀(opencode/ 或 opencode-go/)区分路由。最容易搞错的是:虽然 onboarding 和文档把两者当一套处理,但 OpenClaw 内部用 provider id 分开,所以模型列表和默认模型配置时要写对前缀。

原文共 7 节,先看 Start Here 路径:/providers/opencode 查看官方原文

第一眼

🏬 为什么要分两层楼?因为它们卖的货架不一样

对人来说,它们都叫 OpenCode;对系统来说,它们是不同货架,需要不同门牌号。

Zen

更像综合馆,常见的是 Claude、GPT、Gemini 这种“多家混合货架”。

Go

更像另一层精选馆,常见的是 Kimi、GLM、MiniMax 这排老师。

为什么要拆 provider id

因为系统真正转单时,要知道你到底在 Zen 楼还是 Go 楼。

🎈 一句话

一把钥匙,两层楼,门牌必须分清。

第二步

🔑 CLI setup 的两条命令,像“告诉前台你今天要先逛哪一层”

虽然都是同一把钥匙,但 onboarding 还是要知道你当前先准备接哪一层。

🧘

--auth-choice opencode-zen

像告诉前台:“我先去 Zen 楼逛。”

🏃

--auth-choice opencode-go

像告诉前台:“我先去 Go 楼逛。”

🪪

OPENCODE_API_KEY

不管你先去哪一层,兜里掏出来的都是同一张会员卡。

📌

为什么文档还提到别名 key

像前台顺手告诉你:门卡也接受旧称呼,但你最好认主名。

第三步

🏷 配置片段在说“默认先让哪层楼的哪位老师上场”

opencode/claude-opus-4-6 这种名字本质上就是楼层 + 柜台号。

opencode/claude-opus-4-6

像 Zen 楼里的一位高阶老师。

opencode-go/glm-5

像 Go 楼里的一位老师,门牌不同,但商场还是同一家。

Billing 和货架

这些都在 OpenCode 自己的后台管理。OpenClaw 只负责拿着门卡去对的柜台。

最后总结

🎈 把 OpenCode 这页压成一句最好记的话

OpenCode 像一座两层楼的模型商场。你用同一张会员卡进门,但点模型时要把楼层号写清楚,不然系统不知道该去哪层找老师。

如果你只想看 Go 那层,下一页的 OpenCode Go 会更聚焦,不用把两层楼一起背。