두 카탈로그는 하나의 OpenCode API 키(
OPENCODE_API_KEY, 별칭
OPENCODE_ZEN_API_KEY)를 공유합니다. OpenClaw는 업스트림의 모델별 라우팅이
정확하게 유지되도록 런타임 제공자 ID를 분리하지만, 온보딩과 문서에서는 이를
하나의 OpenCode 설정으로 취급합니다.
시작하기
- Zen 카탈로그
- Go 카탈로그
권장 용도: 엄선된 OpenCode 멀티 모델 프록시(Claude, GPT, Gemini, GLM,
DeepSeek, Kimi, MiniMax, Qwen).또는 키를 직접 전달합니다.
1
온보딩 실행
2
Zen 모델을 기본값으로 설정
3
모델 사용 가능 여부 확인
설정 예시
기본 제공 카탈로그
Zen
현재 전체 목록을 보려면
openclaw models list --provider opencode를 실행하세요.
이 목록에는 opencode/big-pickle 및 opencode/deepseek-v4-flash-free와 같은
무료 등급 항목도 포함됩니다.
Go
전체 Go 모델 표는 OpenCode Go를 참조하세요.
고급 설정
API 키 별칭
API 키 별칭
OPENCODE_ZEN_API_KEY도 OPENCODE_API_KEY의 별칭으로 사용할 수 있습니다.공유 자격 증명
공유 자격 증명
설정 중 OpenCode 키 하나를 입력하면 두 런타임 제공자의 자격 증명이 모두
저장됩니다. 각 카탈로그를 별도로 온보딩할 필요가 없습니다.
API 키 발급
API 키 발급
OpenCode 계정을 만들고 opencode.ai/auth에서
API 키를 생성하세요. 결제 및 카탈로그 사용 가능 여부는 OpenCode 대시보드에서
관리합니다.
Gemini 재생 동작
Gemini 재생 동작
Gemini 기반 OpenCode 참조는 프록시 Gemini 경로를 유지하므로, OpenClaw는
네이티브 Gemini 재생 검증이나 부트스트랩 재작성을 활성화하지 않고 해당
경로에서 Gemini 사고 서명 정제를 유지합니다.
Gemini 이외 모델의 재생 동작
Gemini 이외 모델의 재생 동작
Gemini 이외의 OpenCode 참조에는 최소한의 OpenAI 호환 재생 정책이 유지됩니다.
관련 문서
OpenCode Go
전체 Go 카탈로그 참조 문서입니다.
모델 선택
제공자, 모델 참조 및 장애 조치 동작을 선택하는 방법입니다.
설정 참조
에이전트, 모델 및 제공자에 대한 전체 설정 참조 문서입니다.