# OpenCode

> 将 OpenCode Zen 和 Go 目录与 OpenClaw 搭配使用

- 网址：https://funcoding.ai/agents/openclaw/providers/opencode/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/opencode

---
OpenCode 在 OpenClaw 中提供两个托管目录：

| 目录 | 前缀            | 运行时提供商 |
| ------- | ----------------- | ---------------- |
| **Zen** | `opencode/...`    | `opencode`       |
| **Go**  | `opencode-go/...` | `opencode-go`    |

两个目录共用一个 OpenCode API key（`OPENCODE_API_KEY`，别名为
`OPENCODE_ZEN_API_KEY`）。OpenClaw 将运行时提供商 ID 分开，以确保
上游按模型路由保持正确，但新手引导和文档将它们视为
同一个 OpenCode 设置。

## 入门指南

**Zen 目录**

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

**运行新手引导**

```bash
openclaw onboard --auth-choice opencode-zen
```

或直接传入密钥：

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

**将 Zen 模型设为默认模型**

```bash
openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6"
```

**验证模型是否可用**

```bash
openclaw models list --provider opencode
```

**Go 目录**

**最适合：**由 OpenCode 托管的 Kimi、GLM、MiniMax、Qwen 和 DeepSeek 模型阵容。

**运行新手引导**

```bash
openclaw onboard --auth-choice opencode-go
```

或直接传入密钥：

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

**将 Go 模型设为默认模型**

```bash
openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.6"
```

**验证模型是否可用**

```bash
openclaw models list --provider opencode-go
```

## 配置示例

```json5
{
  env: { OPENCODE_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}
```

## 内置目录

### Zen

| 属性         | 值                                                                                         |
| ---------------- | --------------------------------------------------------------------------------------------- |
| 运行时提供商 | `opencode`                                                                                    |
| 示例模型   | `opencode/claude-opus-4-6`、`opencode/gpt-5.5`、`opencode/gemini-3.1-pro`、`opencode/glm-5.2` |

运行 `openclaw models list --provider opencode` 可查看当前完整列表，其中
还包括 `opencode/big-pickle` 和
`opencode/deepseek-v4-flash-free` 等免费层级条目。

### Go

| 属性         | 值                                                                    |
| ---------------- | ------------------------------------------------------------------------ |
| 运行时提供商 | `opencode-go`                                                            |
| 示例模型   | `opencode-go/kimi-k2.6`、`opencode-go/glm-5`、`opencode-go/minimax-m2.5` |

有关完整的 Go 模型表，请参阅 [OpenCode Go](https://funcoding.ai/agents/openclaw/providers/opencode-go/)。

## 高级配置

<details>
<summary>API key 别名</summary>

`OPENCODE_ZEN_API_KEY` 也可作为 `OPENCODE_API_KEY` 的别名使用。

</details>

<details>
<summary>共享凭证</summary>

在设置期间输入一个 OpenCode 密钥，即会为两个运行时
提供商存储凭证。无需分别为每个目录运行新手引导。

</details>

<details>
<summary>获取 API key</summary>

创建 OpenCode 账户，并在
[opencode.ai/auth](https://opencode.ai/auth) 生成 API key。计费和目录
可用性通过 OpenCode 控制面板管理。

</details>

<details>
<summary>Gemini 重放行为</summary>

由 Gemini 支持的 OpenCode 引用继续使用代理 Gemini 路径，因此 OpenClaw 会在该路径
保留 Gemini 思维签名清理，而不会启用原生 Gemini
重放验证或引导重写。

</details>

<details>
<summary>非 Gemini 重放行为</summary>

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

</details>

## 相关内容

- [OpenCode Go](https://funcoding.ai/agents/openclaw/providers/opencode-go/)：完整的 Go 目录参考。
- [模型选择](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：选择提供商、模型引用和故障转移行为。
- [配置参考](https://funcoding.ai/agents/openclaw/gateway/configuration-reference/)：智能体、模型和提供商的完整配置参考。