Model Providers: OpenClaw에서 LLM 연결하기

저도 예전에 새로운 LLM이 나올 때마다 API 문서를 뒤지고 코드를 일일이 수정하느라 시간을 다 버린 적이 있어요. 개발에만 집중하고 싶은데 설정 단계에서 진이 빠지면 정말 짜증 나죠. OpenClaw는 이런 번거로움을 없애고 여러분이 원하는 모델을 즉시 연결할 수 있도록 도와줍니다.

여러 모델을 번갈아 가며 테스트해야 하는 상황이라면 OpenClaw의 유연한 설정 방식이 정말 반가울 거예요. 복잡한 과정 없이 바로 시작해 보겠습니다.

필요한 것

시작하기 전에 다음 사항들이 준비되었는지 확인해 주세요.

OpenClaw가 설치된 작업 환경
사용하려는 Provider의 API 키 (OpenAI, Anthropic 등)

Quick Start (딱 2단계)

OpenClaw에서 모델을 설정하는 과정은 5분도 걸리지 않을 만큼 간단합니다.

우선 터미널에서 openclaw onboard 명령어를 실행해 주세요. 화면의 안내에 따라 Provider 인증을 진행하면 됩니다.
인증이 끝났다면 설정 파일에서 사용할 기본 모델을 지정하세요. 아래 예시처럼 provider/model 형식을 지켜주면 됩니다.

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6"
      }
    }
  },
}

지원하는 Provider 목록

OpenClaw는 이미 시장의 주요 Provider들을 지원하고 있어요.

이외에도 xAI, Groq, Mistral 같은 다양한 옵션이 준비되어 있습니다. 전체 목록은 Model providers 상세 페이지를 참고해 주세요.

문제 해결

설정 중에 문제가 생겼나요? 가장 자주 발생하는 두 가지 상황을 정리했습니다.

인증 오류가 발생할 때: API 키가 환경 변수에 제대로 등록되었는지 다시 확인해 보세요. openclaw onboard를 다시 실행하는 것이 가장 빠릅니다.
모델을 찾을 수 없다고 나올 때: provider/model 형식에서 슬래시(/) 앞뒤에 오타가 없는지 체크해 주세요. 각 Provider 페이지에서 정확한 모델 ID를 확인할 수 있습니다.

설정하다가 막히는 부분이 있다면 언제든 AI Setup Assistant에게 물어보세요!

다음 단계

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.