OpenCode Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: OpenCode

개요

이 페이지는 OpenClaw OpenCode provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Use OpenCode Zen and Go catalogs with OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Catalog	Prefix	Runtime provider
Zen	opencode/...	opencode
Go	opencode-go/...	opencode-go

공식 문서 기반 상세

아래는 공식 providers/opencode 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

OpenCode exposes two hosted catalogs in OpenClaw:

Catalog	Prefix	Runtime provider
Zen	opencode/...	opencode
Go	opencode-go/...	opencode-go

Both catalogs share one OpenCode API key (OPENCODE_API_KEY, alias OPENCODE_ZEN_API_KEY). OpenClaw keeps the runtime provider ids split so upstream per-model routing stays correct, but onboarding and docs treat them as one OpenCode setup.

시작하기

**Best for:** the curated OpenCode multi-model proxy (Claude, GPT, Gemini, GLM,
DeepSeek, Kimi, MiniMax, Qwen).


  

Run onboarding

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

    Or pass the key directly:

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

  

Set a Zen model as the default

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

  

Verify models are available

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






**Best for:** the OpenCode-hosted Kimi, GLM, MiniMax, Qwen, and DeepSeek lineup.


  

Run onboarding

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

    Or pass the key directly:

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

  

Set a Go model as the 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
    ```
  

설정 예시

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

Built-in catalogs

Zen

Property	Value
Runtime provider	opencode
Example models	opencode/claude-opus-4, opencode/gpt-5.5, opencode/gemini-3.1-pro, opencode/glm-5.2

Run openclaw models list --provider opencode for the full current list, which also includes free-tier rows such as opencode/big-pickle and opencode/deepseek-v4-flash-free.

Go

Property	Value
Runtime provider	opencode-go
Example models	opencode-go/kimi-k2.6, opencode-go/glm-5, opencode-go/minimax-m2.5

See OpenCode Go for the full Go model table.

고급 설정

API key aliases

`OPENCODE_ZEN_API_KEY` is also accepted as an alias for `OPENCODE_API_KEY`.

Shared credentials

Entering one OpenCode key during setup stores credentials for both runtime
providers. You do not need to onboard each catalog separately.

Getting an API key

Create an OpenCode account and generate an API key at
[opencode.ai/auth](https://opencode.ai/auth). Billing and catalog
availability are managed from the OpenCode dashboard.

Gemini replay behavior

Gemini-backed OpenCode refs stay on the proxy-Gemini path, so OpenClaw keeps
Gemini thought-signature sanitation there without enabling native Gemini
replay validation or bootstrap rewrites.

Non-Gemini replay behavior

Non-Gemini OpenCode refs keep the minimal OpenAI-compatible replay policy.

관련 문서

Full Go catalog reference.


Choosing providers, model refs, and failover behavior.


Full config reference for agents, models, and providers.

검증 체크리스트

• openclaw models list --provider opencode 로 모델이 보이는지 확인
• 기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
• API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
• failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

관련

• Provider 목록 인덱스
• 로컬 모델과 Provider
• 공식: Provider directory, Model providers