Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

OpenCode 在 OpenClaw 中提供两个托管目录：
CatalogPrefixRuntime provider
Zenopencode/...opencode
Goopencode-go/...opencode-go
这两个目录都使用同一个 OpenCode API key。OpenClaw 会将运行时提供方 id 分开，以便上游按模型路由时保持正确，但入门和文档会将它们视为同一个 OpenCode 配置。

​
开始使用

最适合： 经过精选的 OpenCode 多模型代理（Claude、GPT、Gemini）。
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/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

PropertyValue
Runtime provideropencode
Example modelsopencode/claude-opus-4-6, opencode/gpt-5.5, opencode/gemini-3-pro

​
Go

PropertyValue
Runtime provideropencode-go
Example modelsopencode-go/kimi-k2.6, opencode-go/glm-5, opencode-go/minimax-m2.5

​
高级配置

OPENCODE_ZEN_API_KEY 也支持作为 OPENCODE_API_KEY 的别名。
在设置过程中输入一个 OpenCode key 会为两个运行时提供方都存储凭据。你不需要分别为每个目录进行入门配置。
你登录 OpenCode，添加计费信息，并复制你的 API key。计费和目录可用性由 OpenCode 控制台管理。
由 Gemini 支持的 OpenCode 引用会保持在代理-Gemini 路径上，因此 OpenClaw 会在该路径上保留 Gemini 思维签名清理，而不会启用原生 Gemini 回放验证或引导重写。
非 Gemini 的 OpenCode 引用会保留最小化的 OpenAI 兼容回放策略。
在设置过程中输入一个 OpenCode key 会为 Zen 和 Go 两个运行时提供方都存储凭据，因此你只需要配置一次。

​
相关内容

模型选择

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

配置参考

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