OpenCode Go Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: OpenCode Go
개요
이 페이지는 OpenClaw OpenCode Go provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Use the OpenCode Go catalog with the shared OpenCode setup
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Runtime provider | opencode-go |
| Auth | OPENCODE_API_KEY (alias: OPENCODE_ZEN_API_KEY) |
| Parent setup | OpenCode |
공식 문서 기반 상세
아래는 공식 providers/opencode-go 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
OpenCode Go is the Go catalog inside OpenCode. It shares
the OPENCODE_API_KEY credential with the Zen catalog, but keeps its own
runtime provider id (opencode-go) so upstream per-model routing stays
correct.
| Property | Value |
|---|---|
| Runtime provider | opencode-go |
| Auth | OPENCODE_API_KEY (alias: OPENCODE_ZEN_API_KEY) |
| Parent setup | OpenCode |
시작하기
Run onboarding
```bash
openclaw onboard --auth-choice opencode-go
```
Set a Go model as default
```bash
openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.6"
```
Verify models are available
```bash
openclaw models list --provider opencode-go
```
Pass the key directly
```bash
openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"
```
Verify models are available
```bash
openclaw models list --provider opencode-go
```
설정 예시
{
env: { OPENCODE_API_KEY: "YOUR_API_KEY_HERE" }, // pragma: allowlist secret
agents: { defaults: { model: { primary: "opencode-go/kimi-k2.6" } } },
}
Built-in catalog
Run openclaw models list --provider opencode-go for the current model list.
Bundled rows:
| Model ref | Name | Context | Max output | Image input |
|---|---|---|---|---|
opencode-go/deepseek-v4-pro |
DeepSeek V4 Pro | 1M | 384K | No |
opencode-go/deepseek-v4-flash |
DeepSeek V4 Flash | 1M | 384K | No |
opencode-go/glm-5 |
GLM-5 | 202,752 | 32,768 | No |
opencode-go/glm-5.1 |
GLM-5.1 | 202,752 | 32,768 | No |
opencode-go/glm-5.2 |
GLM-5.2 | 1M | 131,072 | No |
opencode-go/hy3-preview |
HY3 Preview | 262,144 | 32,768 | No |
opencode-go/kimi-k2.5 |
Kimi K2.5 | 262,144 | 65,536 | Yes |
opencode-go/kimi-k2.6 |
Kimi K2.6 | 262,144 | 65,536 | Yes |
opencode-go/kimi-k2.7-code |
Kimi K2.7 Code | 262,144 | 262,144 | Yes |
opencode-go/mimo-v2.5 |
MiMo V2.5 | 1M | 128,000 | Yes |
opencode-go/mimo-v2.5-pro |
MiMo V2.5 Pro | 1,048,576 | 128,000 | No |
opencode-go/minimax-m2.5 |
MiniMax M2.5 | 204,800 | 65,536 | No |
opencode-go/minimax-m2.7 |
MiniMax M2.7 | 204,800 | 131,072 | No |
opencode-go/minimax-m3 |
MiniMax M3 | 204,800 | 131,072 | No |
opencode-go/qwen3.5-plus |
Qwen3.5 Plus | 262,144 | 65,536 | Yes |
opencode-go/qwen3.6-plus |
Qwen3.6 Plus | 262,144 | 65,536 | Yes |
opencode-go/qwen3.7-max |
Qwen3.7 Max | 1M | 65,536 | No |
opencode-go/qwen3.7-plus |
Qwen3.7 Plus | 1M | 65,536 | Yes |
고급 설정
Routing behavior
OpenClaw routes any `opencode-go/...` model ref automatically. No extra
provider config is required.
Runtime ref convention
Runtime refs stay explicit: `opencode/...` for Zen, `opencode-go/...` for
Go. This keeps upstream per-model routing correct across both catalogs.
Shared credentials
One `OPENCODE_API_KEY` covers both the Zen and Go catalogs. Entering the
key during setup stores credentials for both runtime providers.
See OpenCode for the shared onboarding overview and the full Zen + Go catalog reference.
관련 문서
Shared onboarding, catalog overview, and advanced notes.
Choosing providers, model refs, and failover behavior.
검증 체크리스트
-
openclaw models list --provider opencode-go로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토