跳转至

OpenCode Go

OpenCode Go 是 OpenCode 内的一项独立付费订阅。它使用与 Zen 相同的 OPENCODE_API_KEY 凭证基础设施,但 Zen 密钥不会自动包含 Go 授权。Go 保留自己的运行时提供者 ID(opencode-go),以确保上游按模型路由保持正确。OpenCode Go 已捆绑在 OpenClaw 软件包中,因此只需完成引导和配置即可;无需单独安装插件。

Property Value
运行时提供者 opencode-go
插件 已捆绑(opencode-go)
身份验证 OPENCODE_API_KEY(别名:OPENCODE_ZEN_API_KEY)
父级设置 OpenCode

开始使用

OpenCode Go 已随 OpenClaw 一同提供。您可以继续使用交互式引导,或直接传入共享的 OpenCode API 密钥。

1. 运行引导

openclaw onboard --auth-choice opencode-go

2. 将 Go 模型设为默认

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

3. 验证模型可用

openclaw models list --provider opencode-go

1. 直接传入密钥

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

2. 验证模型可用

openclaw models list --provider opencode-go

配置示例

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

模型目录

运行 openclaw models list --provider opencode-go 可获取当前模型列表。OpenClaw 会显示 Go 的模型列表所公布的所有模型 ID,并使用来自 https://models.opencode.ai/api.json 的元数据对其进行丰富,因此新模型无需更新 OpenClaw 即可出现。元数据尚未描述的 ID 会使用 Go 的 OpenAI 兼容路由并采用默认限制。OpenClaw 还会在模型列表请求中以 openclaw/<version> User-Agent 标识自身。上游目录仅当配置了 OpenCode Zen 或 Go、或使用 OpenCode 凭证显式选择它们时才会下载并缓存;绝不会在启动时或使用无关提供者时获取。

示例引用包括 opencode-go/deepseek-v4-flash、opencode-go/kimi-k3 和 opencode-go/qwen3.8-max。请使用 CLI 获取当前阵容,而不要将这些示例视为完整清单。OpenClaw 会从主动发现中排除已弃用的条目,并将刷新后的生命周期状态应用于其离线回退。捆绑的预览条目将保持隐藏,直到上游元数据提供它们。捆绑种子数据中已有的显式引用仍然可解析。

Go 的模型列表端点是一个通用清单,而非账户授权检查。成功列出模型并不授予访问权限:推理仍然需要有效的 Go 订阅,包括促销模型在内。

DeepSeek V4 模型在智能体回合和独立补全中应用相同的思考控制。显式的 off 会禁用原生思考,并从重放历史中移除推理;启用思考则会保留后续回合所需的推理。两条路径还会省略 MiniMax 模型(具有固定推理)不支持的控件,并移除 Kimi K2 的推理重放字段。

隐私

保留和训练政策因模型而异。在使用模型之前,请查看当前的 OpenCode Go 隐私表,因为提供者政策可能会独立于 OpenClaw 发生变化。

高级配置

路由行为

OpenClaw 会自动路由任何 opencode-go/... 模型引用。无需额外提供者配置。

运行时引用约定

运行时引用保持显式:opencode/... 用于 Zen,opencode-go/... 用于 Go。这可以确保两个目录中的上游按模型路由保持正确。

共享凭证

同一个 OPENCODE_API_KEY 可以同时认证两个运行时提供者,因此设置中可以同时存储两个配置文件。Go 访问权限仍需要在 OpenCode 控制台中单独购买付费订阅。

Tip

有关共享引导概览以及完整的 Zen + Go 目录参考,请参阅 OpenCode。

OpenCode(父级)

共享引导、模型目录概览和高级说明。

模型选择

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

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