Providers
OpenCode
OpenCode는 OpenClaw에서 호스팅되는 두 가지 카탈로그를 제공합니다.
| 카탈로그 | 접두사 | 런타임 제공자 |
|---|---|---|
| Zen | opencode/... |
opencode |
| Go | opencode-go/... |
opencode-go |
두 카탈로그는 하나의 OpenCode API 키(OPENCODE_API_KEY, 별칭
OPENCODE_ZEN_API_KEY)를 공유합니다. OpenClaw는 업스트림의 모델별 라우팅이
정확하게 유지되도록 런타임 제공자 ID를 분리하지만, 온보딩과 문서에서는 이를
하나의 OpenCode 설정으로 취급합니다.
시작하기
Zen 카탈로그
권장 용도: 엄선된 OpenCode 멀티 모델 프록시(Claude, GPT, Gemini, GLM, DeepSeek, Kimi, MiniMax, Qwen).
온보딩 실행
openclaw onboard --auth-choice opencode-zen또는 키를 직접 전달합니다.
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"Zen 모델을 기본값으로 설정
openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6"모델 사용 가능 여부 확인
openclaw models list --provider opencodeGo 카탈로그
권장 용도: OpenCode에서 호스팅하는 Kimi, GLM, MiniMax, Qwen 및 DeepSeek 모델군.
온보딩 실행
openclaw onboard --auth-choice opencode-go또는 키를 직접 전달합니다.
openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"Go 모델을 기본값으로 설정
openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.6"모델 사용 가능 여부 확인
openclaw models list --provider opencode-go설정 예시
{ 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를 참조하세요.
고급 설정
API 키 별칭
OPENCODE_ZEN_API_KEY도 OPENCODE_API_KEY의 별칭으로 사용할 수 있습니다.
공유 자격 증명
설정 중 OpenCode 키 하나를 입력하면 두 런타임 제공자의 자격 증명이 모두 저장됩니다. 각 카탈로그를 별도로 온보딩할 필요가 없습니다.
API 키 발급
OpenCode 계정을 만들고 opencode.ai/auth에서 API 키를 생성하세요. 결제 및 카탈로그 사용 가능 여부는 OpenCode 대시보드에서 관리합니다.
Gemini 재생 동작
Gemini 기반 OpenCode 참조는 프록시 Gemini 경로를 유지하므로, OpenClaw는 네이티브 Gemini 재생 검증이나 부트스트랩 재작성을 활성화하지 않고 해당 경로에서 Gemini 사고 서명 정제를 유지합니다.
Gemini 이외 모델의 재생 동작
Gemini 이외의 OpenCode 참조에는 최소한의 OpenAI 호환 재생 정책이 유지됩니다.
