OpenCode

OpenCode 在 OpenClaw 中公开了两个托管目录：

目录	前缀	运行时提供商
Zen	`opencode/...`	`opencode`
Go	`opencode-go/...`	`opencode-go`

这两个目录使用同一个 OpenCode API 密钥。OpenClaw 将运行时提供商 ID 分开，以便上游按模型路由保持正确，但新手引导和文档将它们视为一个 OpenCode 设置。

入门指南

最适合： 精选的 OpenCode 多模型代理 (Claude, GPT, Gemini)。

运行新手引导

openclaw onboard --auth-choice opencode-zen

或者直接传递密钥：

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

将 Zen 模型设置为默认

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

验证模型可用

openclaw models list --provider opencode

最适合： OpenCode 托管的 Kimi、GLM 和 MiniMax 系列。

运行新手引导

openclaw onboard --auth-choice opencode-go

或者直接传递密钥：

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

将 Go 模型设置为默认

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

验证模型可用

openclaw models list --provider opencode-go

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

属性	值
运行时提供商	`opencode`
示例模型	`opencode/claude-opus-4-6`, `opencode/gpt-5.5`, `opencode/gemini-3-pro`

属性	值
运行时提供商	`opencode-go`
示例模型	`opencode-go/kimi-k2.6`, `opencode-go/glm-5`, `opencode-go/minimax-m2.5`

API 密钥别名

OPENCODE_ZEN_API_KEY 也被支持作为 OPENCODE_API_KEY 的别名。

共享凭证

在设置期间输入一个 OpenCode 密钥即可为这两个运行时提供商存储凭证。您无需分别为每个目录进行入职。

计费和仪表板

您登录 OpenCode，添加计费详情，并复制您的 API 密钥。计费和目录可用性通过 OpenCode 仪表板进行管理。

Gemini 重放行为

由 Gemini 支持的 OpenCode 引用停留在代理 Gemini 路径上，因此 OpenClaw 在那里保持 Gemini 思维签名清理，而无需启用原生 Gemini 重放验证或引导重写。

非 Gemini 重放行为

非 Gemini 的 OpenCode 引用保持最小的 OpenAI 兼容重放策略。