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 Chat Completions 和 OpenAI Responses 传输层向 https://opencode.ai 发出的请求中发送稳定的 x-opencode-session 会话头。当提示缓存被禁用时，此头部仍保持启用。底层 SDK 流式调用方应在其流选项中提供 sessionId。

独立的 openclaw infer model run --local 调用以及准备好的补全辅助工具在未提供显式路由头或会话标识符时，会为每次调用生成一个新的路由头。此生成的值保留在头部中，不会创建会话，也不会启用基于会话的缓存。无论头部名称的大小写如何，显式的模型或调用方路由头都会被保留。

开始使用¶

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

1. 运行引导流程

openclaw onboard --auth-choice opencode-zen

或者直接传入密钥：

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

2. 将 Zen 模型设置为默认模型

openclaw config set agents.defaults.model.primary "opencode/gpt-5.6-sol"

3. 验证模型可用

openclaw models list --provider opencode

**最适合：** 单独订阅的 Go 产品线，涵盖 DeepSeek、GLM、GPT、
Grok、Hy3、Kimi、MiMo、MiniMax 和 Qwen。

1. 使用随附的 Go 目录

OpenCode Go 已随 OpenClaw 一并提供，因此无需单独安装插件或重启 Gateway。

2. 运行引导流程

openclaw onboard --auth-choice opencode-go

或者直接传入密钥：

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

3. 将 Go 模型设置为默认模型

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

4. 验证模型可用

openclaw models list --provider opencode-go

配置示例¶

{
  env: { vars: { OPENCODE_API_KEY: "sk-..." } },
  agents: { defaults: { model: { primary: "opencode/gpt-5.6-sol" } } },
}

提供方目录¶

Zen¶

属性	值
运行时提供方	`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 的权威模型元数据相结合。OpenClaw 仅在配置了 OpenCode Zen 或 Go，或显式选择使用 OpenCode 凭据时，才会获取并缓存该目录；启动过程和不相关的提供方永远不会下载它。当新上游模型的元数据描述了受信任 OpenCode 端点上受支持的传输方式时，无需更新 OpenClaw 即可使用这些模型。按密钥作用域的响应可能会省略该工作区不可用的模型。元数据和生命周期状态会一起刷新；已弃用的模型将从活跃发现及其离线回退中排除。对于现有配置，已弃用的显式引用仍可解析，但不会作为当前推荐显示。

账户列表失败会产生失败的目录结果，而不是成功的种子列表。成功的空响应或完全过滤后的账户响应保持为空。单独的公共元数据源在其不可用时仍可使用受信任的离线元数据；这不会替换或重试账户列表请求。

价格估算也会通过托管模型目录刷新，使用与实时发现相同的公共 OpenCode 定价源。托管更新在下次 Gateway 重启后生效；随附的快照在离线状态下仍然可用。您的配置或代理本地 models.json 中的显式模型价格保持优先。这些是基于公布价格的估算值，而非已核实的发票总额。

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 的别名被接受。

共享凭据

在设置过程中输入一个 OpenCode 密钥可以为两个运行时提供方存储凭据。这不会创建 Go 订阅或授予 Go 权益；使用前请在 OpenCode 控制台中订阅 Go。

获取 API 密钥

在 opencode.ai/auth 创建 OpenCode 账户并生成 API 密钥。账单和目录可用性在 OpenCode 仪表板中管理。

Gemini 重放行为

基于 Gemini 的 OpenCode 引用仍走 proxy-Gemini 路径，因此 OpenClaw 在该路径中保留 Gemini 思维签名清理，而不启用原生 Gemini 重放验证或引导重写。

非 Gemini 重放行为

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

定价和隐私

账单、数据保留和训练策略因模型而异。选择路由前，请查看当前的 OpenCode Zen 定价和政策。免费模型可能是临时反馈计划。

OpenCode Go

Go 目录发现和访问要求。

模型选择

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

配置参考

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

OpenCode 插件参考

原生会话、会话目录切换和插件配置键。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw