메인 콘텐츠로 건너뛰기

​
OpenRouter

OpenRouter는 단일 엔드포인트와 API 키 뒤에서 요청을 많은 모델로 라우팅하는 통합 API를 제공합니다. OpenAI 호환이므로 대부분의 OpenAI SDK는 base URL만 바꾸면 동작합니다.

​
시작하기

1

API 키 받기

openrouter.ai/keys에서 API 키를 생성하세요.
2

온보딩 실행

openclaw onboard --auth-choice openrouter-api-key
3

(선택 사항) 특정 모델로 전환

온보딩의 기본값은 openrouter/auto입니다. 나중에 구체적인 모델을 선택할 수 있습니다:
openclaw models set openrouter/<provider>/<model>

​
구성 예시

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/auto" },
    },
  },
}

​
모델 참조

모델 참조는 openrouter/<provider>/<model> 패턴을 따릅니다. 사용 가능한 provider와 모델의 전체 목록은 /concepts/model-providers를 참고하세요.

​
인증 및 헤더

OpenRouter는 내부적으로 API 키를 사용한 Bearer 토큰을 사용합니다. 실제 OpenRouter 요청(https://openrouter.ai/api/v1)에서는 OpenClaw가 OpenRouter 문서에 있는 앱 귀속 헤더도 추가합니다:
헤더값
HTTP-Refererhttps://openclaw.ai
X-OpenRouter-TitleOpenClaw
X-OpenRouter-Categoriescli-agent
OpenRouter provider를 다른 프록시나 base URL로 다시 지정하면 OpenClaw는 이러한 OpenRouter 전용 헤더나 Anthropic 캐시 마커를 주입하지 않습니다.

​
고급 참고 사항

확인된 OpenRouter 경로에서는 Anthropic 모델 참조가 OpenClaw가 system/developer 프롬프트 블록에서 더 나은 프롬프트 캐시 재사용을 위해 사용하는 OpenRouter 전용 Anthropic cache_control 마커를 유지합니다.
지원되는 non-auto 경로에서 OpenClaw는 선택한 thinking 수준을 OpenRouter 프록시 추론 페이로드로 매핑합니다. 지원되지 않는 모델 힌트와 openrouter/auto는 이 추론 주입을 건너뜁니다.
OpenRouter는 여전히 프록시 스타일 OpenAI 호환 경로를 사용하므로, serviceTier, Responses store, OpenAI 추론 호환 페이로드, 프롬프트 캐시 힌트 같은 기본 OpenAI 전용 요청 셰이핑은 전달되지 않습니다.
Gemini 기반 OpenRouter 참조는 프록시-Gemini 경로에 그대로 남습니다. OpenClaw는 그곳에서 Gemini thought-signature 정리를 유지하지만, 기본 Gemini 재생 검증이나 부트스트랩 재작성은 활성화하지 않습니다.
모델 params 아래에 OpenRouter provider 라우팅을 전달하면 OpenClaw는 공유 스트림 래퍼가 실행되기 전에 이를 OpenRouter 라우팅 메타데이터로 전달합니다.

​
관련 항목

모델 선택

provider, 모델 참조, 장애 조치 동작 선택하기.

구성 참조

agent, 모델, provider를 위한 전체 구성 참조.