OpenCode

将 OpenCode Zen 和 Go 目录与 OpenClaw 搭配使用

OpenCode 在 OpenClaw 中提供两个托管目录：

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

两个目录共用一个 OpenCode API key（OPENCODE_API_KEY，别名为 OPENCODE_ZEN_API_KEY）。OpenClaw 将运行时提供商 ID 分开，以确保上游按模型路由保持正确，但新手引导和文档将它们视为同一个 OpenCode 设置。

入门指南

Zen 目录

**最适合：**精选的 OpenCode 多模型代理（Claude、GPT、Gemini、GLM、 DeepSeek、Kimi、MiniMax、Qwen）。

运行新手引导

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

Go 目录

**最适合：**由 OpenCode 托管的 Kimi、GLM、MiniMax、Qwen 和 DeepSeek 模型阵容。

运行新手引导

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.1-pro`、`opencode/glm-5.2`

运行 openclaw models list --provider opencode 可查看当前完整列表，其中还包括 opencode/big-pickle 和 opencode/deepseek-v4-flash-free 等免费层级条目。

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

有关完整的 Go 模型表，请参阅 OpenCode Go。

API key 别名

OPENCODE_ZEN_API_KEY 也可作为 OPENCODE_API_KEY 的别名使用。

共享凭证

在设置期间输入一个 OpenCode 密钥，即会为两个运行时提供商存储凭证。无需分别为每个目录运行新手引导。

获取 API key

创建 OpenCode 账户，并在 opencode.ai/auth 生成 API key。计费和目录可用性通过 OpenCode 控制面板管理。

Gemini 重放行为

由 Gemini 支持的 OpenCode 引用继续使用代理 Gemini 路径，因此 OpenClaw 会在该路径保留 Gemini 思维签名清理，而不会启用原生 Gemini 重放验证或引导重写。

非 Gemini 重放行为

非 Gemini OpenCode 引用保留最精简的 OpenAI 兼容重放策略。