메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenCode는 OpenClaw에서 두 가지 호스팅 카탈로그를 제공합니다:
카탈로그접두사런타임 provider
Zenopencode/...opencode
Goopencode-go/...opencode-go
두 카탈로그 모두 동일한 OpenCode API 키를 사용합니다. OpenClaw는 업스트림 모델별 라우팅이 올바르게 유지되도록 런타임 provider id를 분리해 두지만, 온보딩과 문서에서는 이를 하나의 OpenCode setup으로 취급합니다.

​
시작하기

적합한 경우: 엄선된 OpenCode 멀티 모델 프록시(Claude, GPT, Gemini).
1

온보딩 실행

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

Zen 모델을 기본값으로 설정

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

모델 사용 가능 여부 확인

openclaw models list --provider opencode

​
config 예시

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

​
내장 카탈로그

​
Zen

속성값
런타임 provideropencode
예시 모델opencode/claude-opus-4-6, opencode/gpt-5.5, opencode/gemini-3-pro

​
Go

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

​
고급 구성

OPENCODE_ZEN_API_KEY도 OPENCODE_API_KEY의 별칭으로 지원됩니다.
setup 중에 하나의 OpenCode 키를 입력하면 두 런타임 provider 모두에 대한 자격 증명이 저장됩니다. 각 카탈로그를 따로 온보딩할 필요는 없습니다.
OpenCode에 로그인하고 청구 정보를 추가한 뒤 API 키를 복사합니다. 청구 및 카탈로그 가용성은 OpenCode 대시보드에서 관리됩니다.
Gemini 기반 OpenCode ref는 프록시-Gemini 경로에 유지되므로, OpenClaw는 네이티브 Gemini 재생 검증이나 bootstrap 재작성을 활성화하지 않고도 그 경로에서 Gemini thought-signature 정리를 유지합니다.
비-Gemini OpenCode ref는 최소 OpenAI 호환 재생 정책을 유지합니다.
setup 중에 하나의 OpenCode 키를 입력하면 Zen 및 Go 런타임 provider 모두에 대한 자격 증명이 저장되므로 한 번만 온보딩하면 됩니다.

​
관련

모델 선택

provider, 모델 ref, failover 동작 선택하기.

구성 참조

에이전트, 모델, provider에 대한 전체 config 참조.