本页内容
本页内容
供应商
OpenCode
OpenCode 在 OpenClaw 中提供两个托管目录:
| 目录 | 前缀 | 运行时提供者 |
|---|---|---|
| Zen | opencode/... |
opencode |
| Go | opencode-go/... |
opencode-go |
两个目录都使用相同的 OpenCode API 密钥基础设施(OPENCODE_API_KEY,别名 OPENCODE_ZEN_API_KEY)。 Go仍然需要自己付费订阅;拥有 Zen 密钥本身并不授予 Go 访问权限。 OpenClaw 保持运行时提供程序 ID 的分割,以便上游每个模型的路由保持正确。
OpenClaw 通过 Anthropic、Gemini、OpenAI 聊天完成和 OpenAI 响应传输向 https://opencode.ai 发送稳定的 x-opencode-session 会话标头。当禁用提示缓存时,此标头保持启用状态。低级 SDK 流调用者应在其流选项中提供 sessionId。
OpenAI- 兼容和 Anthropic 传输上的 Zen 和 Go 发现请求和模型请求将客户端在其本机端点上标识为 openclaw/<version>。自定义代理 URL 不会继承此属性。 google-generative-ai SDK 路径尚未应用此用户代理策略。 OpenClaw 不会模拟 OpenCode 客户端。
当未提供显式路由标头或会话标识符时,独立 openclaw infer model run --local 调用和 prepared 完成助手 每次调用都会生成新的路由标头。此生成的值保留在标头中,不会创建对话或启用基于会话的缓存。无论标头名称大小写如何,都会保留显式模型或调用者路由标头。
入门
禅宗目录
最佳适用场景: 精选的 OpenCode 多模型代理(Claude、GPT、Gemini、GLM、 DeepSeek、Kimi、MiniMax、Qwen)。
运行入门引导培训
或直接传入密钥:
将 Zen 模型设置为默认模型
验证模型是否可用
Go目录
最佳适用场景: 分别订阅的 Go 系列,涵盖 DeepSeek、GLM、GPT、 Grok、Hy3、Kimi、MiMo、MiniMax 和 Qwen。
使用捆绑的 Go 目录
OpenCode Go 包含在 OpenClaw 中,因此不需要单独安装插件或重新启动网关。
运行入门引导培训
或直接传入密钥:
将 Go 模型设置为默认模型
验证模型是否可用
配置示例
提供商目录
禅宗
| 属性 | 值 |
|---|---|
| 运行时提供者 | opencode |
| 示例模型 | opencode/gpt-5.6-sol, opencode/kimi-k3, opencode/deepseek-v4-flash |
对当前活动列表运行 openclaw models list --provider opencode。模型可用性和促销路线可以独立于 OpenClaw 进行更改。
实时发现将您的 OpenCode 帐户可用的模型与来自 https://models.opencode.ai/api.json 的权威模型元数据相结合。仅当使用 OpenCode 凭证配置或显式选择 OpenCode Zen 或 Go 时,OpenClaw 才会获取并缓存该目录;启动和不相关的提供商永远不会下载它。新列出的聊天模型无需 OpenClaw 更新即可使用。具有可信元数据的模型保留其上游传输和功能;列出的没有元数据的 ID 使用 Zen 的本机 OpenAI- 兼容路由,并具有默认限制。键范围的响应可以忽略该工作区不可用的模型。元数据和生命周期状态一起刷新;已弃用的模型被排除在主动发现及其离线回退之外。已弃用的显式引用仍然可以解析为现有配置,但不会显示为当前建议。
帐户列表失败会产生失败的目录结果,而不是成功的种子列表。成功的空或完全过滤的帐户响应将保持为空。单独的公共元数据源在可信离线元数据不可用时仍然可以使用;不会替换或重试帐户列表请求。
某些 Zen 免费层模型仅接受来自 OpenCode 客户端的请求。 403 FreeTierError 表示该模型的免费套餐受到限制,而不是您保存的密钥已过期。选择其他模型或使用允许 API 访问的付费计划。再次登录或更改用户代理不会授予访问权限。此拒绝仅标记所选模型不可用;它不会将其他模型的凭证置于冷却状态。仅帐户列表中的 ID 并不能证明它可以在 OpenClaw 中运行。该列表没有免费层标志,因此 OpenClaw 不会根据模型名称猜测访问权限。 402 资金不足响应意味着该帐户需要更多信用,而不是模型 ID 未知。
价格估算还通过 托管模型目录 进行刷新,使用与实时发现相同的公共 OpenCode 定价源。托管更新在下次网关重新启动后激活;捆绑的快照仍然可以离线使用。您的配置或代理本地 models.json 中的明确模型价格保持优先。这些是广告价格估算,而不是经过验证的发票总额。
Kimi K3 思维
对于 opencode/kimi-k3,选择 Off、Low、High 或 Max。其提供程序默认值为 High。 Off 显式发送 reasoning_effort: "none";省略努力并不会禁用禅宗的推理。这些选择适用于 Zen 路线,而不适用于其他 Kimi 提供商。拾取器还可能显示 Ultra,这是一种单独的harness模式。
Go
| 属性 | 值 |
|---|---|
| 运行时提供者 | opencode-go |
| 示例模型 | opencode-go/kimi-k3, opencode-go/deepseek-v4-flash, opencode-go/qwen3.8-max |
有关发现、路由和访问要求,请参阅 OpenCode Go。 Go 的模型列表端点宣传其总体阵容;列出模型并不能证明您的帐户可以运行它。
高级配置
API 密钥别名
OPENCODE_ZEN_API_KEY 也可作为 OPENCODE_API_KEY 的别名使用。
获取 API 密钥
创建 OpenCode 帐户并在 opencode.ai/auth. 生成 API 密钥计费和目录可用性通过 OpenCode 仪表板进行管理。
Gemini 重播行为
Gemini-支持的OpenCode引用保留在代理Gemini路径上,因此OpenClaw在那里保持Gemini思想签名卫生,而不启用本机Gemini重播验证或引导重写。
非 Gemini 重播行为
非 Gemini OpenCode 裁判保留最低 OpenAI- 兼容重播策略。
定价和隐私
计费、数据保留和训练政策因模型而异。在选择路径前,请查看最新的 OpenCode Zen 定价和政策。 免费模型可能属于临时性的反馈计划。