메인 콘텐츠로 건너뛰기
OpenCode는 OpenClaw에서 두 개의 호스팅 카탈로그를 제공합니다:
카탈로그접두사런타임 제공자
Zenopencode/...opencode
Goopencode-go/...opencode-go
두 카탈로그 모두 같은 OpenCode API 키를 사용합니다. OpenClaw는 업스트림 모델별 라우팅이 올바르게 유지되도록 런타임 제공자 ID를 분리해 두지만, 온보딩과 문서에서는 이를 하나의 OpenCode 설정으로 다룹니다.

​
시작하기

가장 적합한 용도: 엄선된 OpenCode 멀티 모델 프록시(Claude, GPT, Gemini, GLM).
1

Run onboarding

openclaw onboard --auth-choice opencode-zen
또는 키를 직접 전달합니다:
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
2

Set a Zen model as the default

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

Verify models are available

openclaw models list --provider opencode

​
설정 예시

{
  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

​
Go

속성값
런타임 제공자opencode-go
예시 모델opencode-go/kimi-k2.6, opencode-go/glm-5, opencode-go/minimax-m2.5

​
고급 설정

OPENCODE_ZEN_API_KEY도 OPENCODE_API_KEY의 별칭으로 지원됩니다.
설정 중 OpenCode 키 하나를 입력하면 두 런타임 제공자의 자격 증명이 저장됩니다. 각 카탈로그를 따로 온보딩할 필요가 없습니다.
OpenCode에 로그인하고 결제 세부 정보를 추가한 뒤 API 키를 복사합니다. 결제 및 카탈로그 사용 가능 여부는 OpenCode 대시보드에서 관리됩니다.
Gemini 기반 OpenCode 참조는 프록시-Gemini 경로에 유지되므로, OpenClaw는 네이티브 Gemini 리플레이 검증이나 부트스트랩 재작성을 활성화하지 않고 그곳에서 Gemini 생각 서명 정리를 유지합니다.
Gemini가 아닌 OpenCode 참조는 최소한의 OpenAI 호환 리플레이 정책을 유지합니다.
설정 중 OpenCode 키 하나를 입력하면 Zen 및 Go 런타임 제공자 모두의 자격 증명이 저장되므로, 온보딩은 한 번만 하면 됩니다.

​
관련 항목

Model selection

제공자, 모델 참조, 장애 조치 동작 선택.

Configuration reference

에이전트, 모델, 제공자를 위한 전체 설정 참조.