모델을 OpenClaw에 연결
클라우드 제공업체의 API 키를 OpenClaw에 설정하고 기본 모델을 선택하거나, LM Studio 또는 vLLM 같은 로컬 서버에 연결하세요.
클라우드 제공업체는 환경 변수에서 키를 읽는 공식 provider 플러그인입니다. 여기에 언급된 제공업체 외에도 약 30개의 제공업체를 지원합니다.
제공업체 키 설정
제공업체의 키를 내보낸 다음, 해당 키로 OpenClaw에서 사용할 수 있는 모델을 확인하세요. OPENAI_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, GROQ_API_KEY 및 DEEPSEEK_API_KEY에도 같은 방식을 사용할 수 있습니다.
shell export ANTHROPIC_API_KEY=sk-ant-... openclaw models list기본 모델 선택
목록에서 provider/model 형식의 모델 ID를 복사해 기본 모델로 설정하세요.
shell openclaw models set <provider/model>LM Studio를 로컬에서 사용
LM Studio 로컬 서버를 시작한 다음, openclaw.json의 models.providers.<id> 아래에 추가하세요. 이때 baseUrl을 설정하고 api는 openai-responses로 지정합니다. ollama-local 같은 임의의 apiKey를 사용할 수 있습니다.
설정 Base URL: http://127.0.0.1:1234/v1 API: openai-responsesvLLM, SGLang 또는 MLX 사용
이 서버는 기본적으로 포트 8000을 사용하며 api를 openai-completions로 설정해야 합니다. 같은 방식으로 models.providers.<id> 아래에 등록하세요. Ollama는 자체 provider를 사용하며, llama.cpp는 관리형 로컬 서버가 포함된 플러그인으로 제공됩니다.
설정 Base URL: http://127.0.0.1:8000/v1 API: openai-completions
로컬 모델은 gateway보다 훨씬 많은 메모리가 필요합니다. 가장 작은 llama.cpp 구성도 약 8 GiB가 필요하므로 클라우드 API 대신 로컬 모델을 사용하기 전에 호스트의 메모리를 확인하세요.