Appearance
OpenClaw 接入 OpenCode 时需要区分两个托管目录：Zen 目录（opencode/...）提供 Claude、GPT、Gemini 等精选模型，Go 目录（opencode-go/...）提供 Kimi、GLM、MiniMax 等模型。两者共用同一个 OpenCode API Key，但运行时提供商 ID 分开，确保上游路由正确。配置只需一次 openclaw onboard 即可同时存储两个 provider 凭据，之后可用 openclaw models list --provider opencode 或 opencode-go 验证模型是否就绪。如果遇到模型列表为空，请检查 API Key 有效性和计费状态。
OpenClaw 接入 OpenCode（Zen 和 Go 目录）配置教程
OpenCode 在 OpenClaw 中提供了两个托管模型目录，每个目录对应一个 runtime provider：
| 目录 | 模型前缀 | Runtime 提供商 |
|---|---|---|
| Zen | opencode/... | opencode |
| Go | opencode-go/... | opencode-go |
两个目录使用同一个 OpenCode API Key。OpenClaw 将 runtime provider ID 分开存储，以确保上游按模型路由正确，但 onboarding 流程和文档把它们当作一套 OpenCode 配置来处理。
配置 Zen 目录
适合需要 Claude、GPT、Gemini 等精选多模型代理的场景。
1. 运行 onboarding
bash
openclaw onboard --auth-choice opencode-zen或者直接传入 API Key：
bash
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"2. 设置默认模型
bash
openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6"3. 验证模型可用性
bash
openclaw models list --provider opencode配置 Go 目录
适合需要 OpenCode 托管的 Kimi、GLM、MiniMax 模型的场景。
1. 运行 onboarding
bash
openclaw onboard --auth-choice opencode-go或者直接传入 API Key：
bash
openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"2. 设置默认模型
bash
openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.6"3. 验证模型可用性
bash
openclaw models list --provider opencode-go配置片段示例
json5
{
env: { OPENCODE_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}内置目录详情
Zen
| 属性 | 值 |
|---|---|
| Runtime provider | opencode |
| 示例模型 | opencode/claude-opus-4-6、opencode/gpt-5.5、opencode/gemini-3-pro |
Go
| 属性 | 值 |
|---|---|
| Runtime provider | opencode-go |
| 示例模型 | opencode-go/kimi-k2.6、opencode-go/glm-5、opencode-go/minimax-m2.5 |
高级配置
API Key 别名
OPENCODE_ZEN_API_KEY 也被支持为 OPENCODE_API_KEY 的别名。使用任一变量均可。
共享凭据
在 onboarding 时输入一个 OpenCode Key，两个 runtime provider 的凭据都会被自动存储。无需分别对每个目录进行认证。
计费与仪表盘
登录 OpenCode 后台，添加计费信息，复制 API Key 即可使用。计费和目录可用性由 OpenCode 控制台管理。
Gemini 模型的重放行为
Gemini 支持的 OpenCode 引用（例如 opencode/gemini-3-pro）会保持在代理-Gemini 路径上，因此 OpenClaw 会在该路径上保留 Gemini thought-signature 清理，但不会启用原生 Gemini 重放验证或 bootstrap 重写。
非 Gemini 模型的重放行为
非 Gemini 的 OpenCode 引用使用最小的 OpenAI 兼容重放策略，不会进行额外清理。
提示：配置时填写一个 OpenCode Key，两个 runtime provider 的凭据都会被存储。你只需要一次 onboard 即可同时使用 Zen 和 Go 目录。
相关文档
常见问题
OpenClaw 接入 OpenCode 时，Zen 和 Go 两个目录有什么区别？
Zen 目录提供 Claude、GPT、Gemini 等精选多模型代理（runtime provider opencode）；Go 目录提供 OpenCode 托管的 Kimi、GLM、MiniMax 模型（runtime provider opencode-go）。两个目录共用同一个 OpenCode API Key，但运行时提供商 ID 分开，确保路由正确。
OpenCode 配置中，OPENCODE_ZEN_API_KEY 和 OPENCODE_API_KEY 是什么关系？
OPENCODE_ZEN_API_KEY 是 OPENCODE_API_KEY 的别名，两者作用相同。设置时只需填写一个，但建议统一使用 OPENCODE_API_KEY 简化配置。
配置完 OpenCode 后如何验证模型列表？
Zen 目录使用 openclaw models list --provider opencode，Go 目录使用 openclaw models list --provider opencode-go。如果列表为空，先确认 API Key 有效且对应模型已开通计费。