OpenRouter로 모든 LLM 한 번에 관리하기

요즘 새로운 LLM이 하루가 멀다 하고 쏟아져 나오죠? 모델마다 API 연동 방식이 달라서 매번 공식 문서를 뒤지는 게 정말 일이에요. 저도 처음엔 모델별로 라이브러리를 일일이 설치하다가 결국 관리 포인트가 너무 많아져서 포기하고 싶었던 적이 한두 번이 아니었거든요. OpenRouter를 사용하면 이런 번거로움을 한 방에 해결할 수 있어요.

필요한 것

시작하기 전에 딱 두 가지만 준비해 주세요.

• OpenRouter 계정과 API Key
• 터미널 환경 (Node.js 기반 도구 사용)

빠른 시작

5분 안에 설정을 끝내고 바로 모델을 호출해 볼게요. OpenRouter는 OpenAI와 호환되는 API 구조를 가지고 있어서 기존 SDK를 그대로 쓸 수 있다는 게 큰 장점이에요.

1. CLI 설정

먼저 터미널에서 아래 명령어를 입력해 인증을 진행해 주세요. OPENROUTER_API_KEY 부분에 발급받은 키를 넣으면 됩니다.

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"

2. Config 업데이트

그다음 config.json5 파일에 환경 변수와 사용할 모델을 지정해 주세요. 여기서는 Anthropic의 Claude 3.5 Sonnet을 기본 모델로 설정하는 예시를 보여드릴게요.

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
    },
  },
}

문제 해결

설정 중에 자주 겪는 문제와 해결 방법이에요.

• 모델 호출 실패: OpenRouter는 모델 이름을 openrouter/<provider>/<model> 형식으로 써야 해요. 슬래시 구분을 빠뜨리지 않았는지 확인해 보세요.
• 인증 오류: API Key가 제대로 입력되었는지 다시 보세요. 내부적으로 Bearer 토큰 방식을 사용하므로 키 앞에 공백이 포함되지 않도록 주의해야 합니다.

설정하다가 막히는 부분이 있나요? AI Setup Assistant에게 물어보면 바로 도와줄 거예요.

다음 단계

• Model Providers 더 알아보기
• OpenClaw 고급 설정 가이드