OpenCode Go 目录是 OpenClaw 中 Go 模型的统一入口，复用 Zen 目录的 OPENCODE_API_KEY，但运行时 provider ID 固定为 opencode-go，确保跨目录模型路由正确。配置可通过 openclaw onboard --auth-choice opencode-go 交互式完成，或用 openclaw onboard --opencode-go-api-key 非交互式传入 key。运行 openclaw models list --provider opencode-go 查看当前可用模型（含内置 registry 补充的最新模型）。支持模型 ref 如 opencode-go/kimi-k2.6、opencode-go/glm-5、opencode-go/deepseek-v4-pro 等。

OpenClaw OpenCode Go 目录模型配置步骤

OpenCode Go 是 OpenCode 的 Go 子目录。它使用与 Zen 目录相同的 OPENCODE_API_KEY，但运行时保留独立的 provider ID opencode-go，确保上游按模型路由正确。

属性	值
Runtime provider	opencode-go
Auth	OPENCODE_API_KEY
父级配置	OpenCode

内置模型目录

OpenClaw 从捆绑的 pi 模型注册表中提供大部分 Go 目录模型，并在注册表追赶时补充当前上游行。运行以下命令查看最新模型列表：

openclaw models list --provider opencode-go

包含以下模型 ref：

Model ref	名称
opencode-go/glm-5	GLM-5
opencode-go/glm-5.1	GLM-5.1
opencode-go/kimi-k2.5	Kimi K2.5
opencode-go/kimi-k2.6	Kimi K2.6 (3x limits)
opencode-go/deepseek-v4-pro	DeepSeek V4 Pro
opencode-go/deepseek-v4-flash	DeepSeek V4 Flash
opencode-go/mimo-v2-omni	MiMo V2 Omni
opencode-go/mimo-v2-pro	MiMo V2 Pro
opencode-go/minimax-m2.5	MiniMax M2.5
opencode-go/minimax-m2.7	MiniMax M2.7
opencode-go/qwen3.5-plus	Qwen3.5 Plus
opencode-go/qwen3.6-plus	Qwen3.6 Plus

配置步骤

交互式配置

1. 运行 onboard 命令并选择 opencode-go：

   openclaw onboard --auth-choice opencode-go

2. 将某个 Go 模型设为默认（例如 Kimi K2.6）：

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

3. 验证模型可用：

   openclaw models list --provider opencode-go

非交互式配置

1. 直接传递 API key：

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

2. 验证模型可用：

   openclaw models list --provider opencode-go

配置示例

{
  env: { OPENCODE_API_KEY: "YOUR_API_KEY_HERE" }, // pragma: allowlist secret
  agents: { defaults: { model: { primary: "opencode-go/kimi-k2.6" } } },
}

高级配置

路由行为

模型 ref 使用 opencode-go/... 时，OpenClaw 自动处理按模型路由，无需额外 provider 配置。

运行时 ref 约定

运行时 ref 保持明确：Zen 目录使用 opencode/...，Go 目录使用 opencode-go/...。这确保上游在两个目录之间的按模型路由正确。

共享凭据

OPENCODE_API_KEY 被 Zen 和 Go 目录共用。设置时输入 key 会同时存储两个运行时 provider 的凭据。

提示：完整 onboard 概览和 Zen + Go 目录参考，请参阅 OpenCode。

相关文档

• OpenCode（父目录）：共享 onboarding、目录概览和高级说明。
• 模型选择：选择 provider、model ref 和故障转移行为。

常见问题

OpenCode Go 和 Zen 目录有什么区别？

两者共享同一个 OPENCODE_API_KEY，但运行时 provider ID 不同（opencode-go vs opencode）。Zen 目录下的模型使用 opencode/... ref，Go 目录使用 opencode-go/... ref。OpenClaw 根据 ref 前缀自动匹配正确的运行时 provider，确保模型路由准确。

怎么查看当前可用的 OpenCode Go 模型列表？

运行 openclaw models list --provider opencode-go。OpenClaw 会从内置 registry 显示最新模型列表，并定期补充上游新增行。

OPENCODE_API_KEY 在哪里设置？

可以通过环境变量 OPENCODE_API_KEY 设置，或在 openclaw onboard 交互过程中输入。也可以在配置文件中 env 字段指定（参见上方配置示例）。该 key 同时用于 Zen 和 Go 目录。