跳转到主要内容
OpenCode 在 OpenClaw 中公开两个托管目录：
目录前缀运行时提供商
Zenopencode/...opencode
Goopencode-go/...opencode-go
两个目录共享同一个 OpenCode API key（OPENCODE_API_KEY，别名 OPENCODE_ZEN_API_KEY）。OpenClaw 将运行时提供商 ID 保持拆分，以确保 上游按模型路由保持正确，但新手引导和文档会将它们视为 一个 OpenCode 设置。

​
入门指南

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

运行新手引导

openclaw onboard --auth-choice opencode-zen
或者直接传入 key：
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
2

将 Zen 模型设为默认值

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

验证模型是否可用

openclaw models list --provider opencode

​
配置示例

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

​
内置目录

​
Zen

属性值
运行时提供商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。

​
Go

属性值
运行时提供商opencode-go
示例模型opencode-go/kimi-k2.6, opencode-go/glm-5, opencode-go/minimax-m2.5
请参阅 OpenCode Go 获取完整的 Go 模型表。

​
高级配置

OPENCODE_ZEN_API_KEY 也可作为 OPENCODE_API_KEY 的别名使用。
在设置期间输入一个 OpenCode key 会为两个运行时 提供商存储凭证。你无需分别引导设置每个目录。
创建 OpenCode 账户并在 opencode.ai/auth 生成 API key。计费和目录 可用性通过 OpenCode 仪表板管理。
由 Gemini 支持的 OpenCode ref 会保留在 proxy-Gemini 路径上，因此 OpenClaw 会在那里保留 Gemini thought-signature 清理，而不会启用原生 Gemini 重放验证或 bootstrap 重写。
非 Gemini OpenCode ref 会保留最小化的 OpenAI 兼容重放策略。

​
相关内容

OpenCode Go

完整的 Go 目录参考。

模型选择

选择提供商、模型 ref 和故障转移行为。

配置参考

智能体、模型和提供商的完整配置参考。