Skip to main content
OpenCode 在 OpenClaw 中提供两个托管目录： 两个目录使用相同的 OpenCode API 密钥基础设施（OPENCODE_API_KEY， 别名为 OPENCODE_ZEN_API_KEY）。Go 仍然需要单独的付费订阅； 拥有 Zen 密钥本身并不会授予 Go 的访问权限。OpenClaw 将运行时提供商 ID 分开， 以确保上游的按模型路由保持正确。

​
开始使用

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

运行入门配置

或者直接传入密钥：
2

将 Zen 模型设为默认值

3

验证模型是否可用

​
配置示例

​
提供方目录

​
Zen

运行 openclaw models list --provider opencode 获取当前可用的模型列表， 其中还包括已推广的免费层模型条目 opencode/big-pickle、 opencode/deepseek-v4-flash-free、opencode/laguna-s-2.1-free、 opencode/ling-3.0-tiny-free、opencode/longcat-2.0-free、 opencode/mimo-v2.5-free、 opencode/nemotron-3-ultra-free 和 opencode/north-mini-code-free。 实时发现功能会将 OpenCode 返回的 ID 与 OpenClaw 的可信元数据进行安全交集处理。按密钥限定的响应可能会省略当前工作区不可用的模型；缺少这些模型并不意味着离线定义已被弃用。已弃用的显式引用对于现有配置仍可解析，但不会显示为当前推荐项。

​
Go

参见 OpenCode Go 获取完整的 Go 模型表。

​
高级配置

OPENCODE_ZEN_API_KEY 也可作为 OPENCODE_API_KEY 的别名使用。
在设置期间输入一个 OpenCode 密钥，可以为两个运行时提供商存储凭据。它不会创建 Go 订阅或授予 Go 使用权；使用 Go 前，请先在 OpenCode 控制台中订阅 Go。
创建一个 OpenCode 账户，并在 opencode.ai/auth 生成 API key。计费和目录 可用性由 OpenCode 仪表板管理。
由 Gemini 支持的 OpenCode 引用会保持在代理-Gemini 路径上，因此 OpenClaw 会在该路径上保留 Gemini 思维签名清理，而不会启用原生 Gemini 回放验证或引导重写。
非 Gemini 的 OpenCode 引用会保留最小化的 OpenAI 兼容回放策略。
计费、数据保留和训练政策因模型而异。在选择路径前，请查看最新的 OpenCode Zen 定价和政策。 免费模型可能属于临时性的反馈计划。

​
相关

OpenCode Go

完整的 Go 目录参考。

模型选择

选择提供方、模型引用和故障切换行为。

配置参考

agents、models 和 providers 的完整配置参考。