OpenClaw VPS 호스팅 — 카페24 LLM Router 연결 가이드
💡 요약 정리
- 카페24 LLM Router의 API를 OpenClaw의 AI 모델로 연결하는 방법입니다.
- 100종+ AI 모델을 하나의 API 키로 사용하고, 가입 시 ₩1,000 무료 크레딧으로 바로 시작할 수 있습니다.
- 순서: ① LLM Router 가입 → ② API 키 생성 → ③ OpenClaw TUI에서 Custom Provider로 연결
- LLM Router는 OpenAI 호환 엔드포인트라, OpenClaw의 Custom Provider로 간단히 연결됩니다.
이 문서는 초기 설정 가이드의 2-4. LLM 모델 연결(TUI 온보딩) 단계에서 LLM Router를 연결하는 경우를 위한 상세 안내입니다. 빠른 시작·SSH 접속 등 앞 단계는 빠른 시작 가이드를 먼저 참고하세요.
1. 카페24 LLM Router 가입
OpenClaw에 연결하려면 먼저 카페24 LLM Router 서비스에 가입해야 합니다.
- 카페24 LLM Router에 접속합니다.
- 카페24 호스팅 회원으로 로그인합니다. (호스팅 회원이 아니라면 먼저 회원가입)
- 약관 동의 후 아이디(신규 자아이디 또는 비어있는 기존 자아이디)를 선택하고 신청 완료합니다.
신청이 완료되면 즉시 ₩1,000 무료 크레딧이 지급되어 바로 사용할 수 있습니다. 가입 시점에 카드 등록은 필요 없습니다.
가입 절차·무료 크레딧·연령 제한 등 자세한 내용은 LLM Router 가입하기 가이드를 참고하세요.
2. API 키 생성
OpenClaw 연결에는 API 키와 Base URL이 필요합니다. LLM Router 콘솔에서 발급합니다.
- LLM Router 콘솔에서 API 키 관리 메뉴로 이동합니다.
- 키 이름 · 크레딧 한도 · 만료일을 설정하고 키를 생성합니다.
- 생성된 API 키 값을 복사해 안전한 곳에 보관합니다.
- Base URL은 OpenClaw에 입력할 값으로
https://llm-router.cafe24.com/api/v1입니다.
API 키 값은 발급 직후 1회만 표시됩니다. 화면을 벗어나면 다시 조회할 수 없으니, 생성 즉시 복사해 안전한 곳에 저장하세요. 분실 시 새 키를 발급해야 합니다.
콘솔 메뉴(모델 비교 · 체험하기 · 사용 현황 · 크레딧 충전 등) 사용법은 처음 시작하는 사용자를 위한 가이드에서 확인할 수 있습니다.
3. OpenClaw에 LLM Router 연결 (TUI 온보딩)
API 키를 준비했다면, OpenClaw 초기 설정의 2-4. LLM 모델 연결 단계에서 아래 순서로 연결합니다. (Hermes Agent와 화면 구성이 다릅니다.)
3-1. Model/auth provider — More… 선택
모델 제공사 선택 화면에서 기본 목록 대신 More…를 선택해 전체 제공사 목록을 엽니다.
◆ Model/auth provider
│ ○ OpenAI
│ ○ Anthropic
│ ○ xAI (Grok)
│ ○ Google
│ ○ OpenRouter
│ ● More…
│ ○ Skip for now
3-2. Custom Provider 선택
전체 목록(검색 가능)이 표시되면 Custom Provider (Any OpenAI or Anthropic compatible endpoint) 를 선택합니다.
◆ Model/auth provider
│
│ Search:
│ ○ OpenAI
│ ○ Anthropic
│ ○ xAI (Grok)
│ ○ Google
│ ○ OpenRouter
│ ○ Arcee AI
│ ○ BytePlus
│ ○ Cerebras
│ ○ Chutes
│ ○ Cloudflare AI Gateway
│ ○ Copilot
│ ● Custom Provider (Any OpenAI or Anthropic compatible endpoint)
│ ○ DeepInfra
│ ○ DeepSeek
│ ○ Fireworks
│ ○ GMI Cloud
│ ○ Google Vertex
│ ... (이하 생략)
3-3. API Base URL 입력
API Base URL에 LLM Router 주소를 입력합니다. (Hermes와 동일한 값)
◇ API Base URL
│ https://llm-router.cafe24.com/api/v1
3-4. API 키 입력
API 키 제공 방식에서 Paste API key now를 선택하고, 발급한 LLM Router API 키를 입력합니다.
◆ How do you want to provide this API key?
│ ● Paste API key now (Stores the key directly in OpenClaw config)
│ ○ Use external secret provider
◇ API key
│ ********
3-5. Endpoint compatibility — OpenAI-compatible 선택
엔드포인트 호환성에서 첫 번째 항목인 OpenAI-compatible (Uses /chat/completions) 를 선택합니다. LLM Router는 OpenAI 호환 엔드포인트입니다.
◆ Endpoint compatibility
│ ● OpenAI-compatible (Uses /chat/completions)
│ ○ OpenAI Responses-compatible
│ ○ Anthropic-compatible
│ ○ Unknown (detect automatically)
3-6. Model ID 입력
사용할 모 델명을 Model ID에 입력합니다.
◆ Model ID
│ e.g. llama3, claude-3-7-sonnet
입력할 모델명(Model ID)은 LLM Router 모델 목록 페이지에서 확인한 뒤 그대로 입력하세요. (예: deepseek-ai/DeepSeek-V3, anthropic/claude-sonnet-4-6 등)
3-7. Endpoint ID · Model alias
Endpoint ID는 자동으로 채워집니다. 그대로 두어도 되고, 원하면 명칭을 변경할 수 있습니다. Model alias는 선택 항목이라 필요할 때만 입력하고, 아니면 그냥 넘어갑니다.
◇ Endpoint ID
│ custom-llm-router-cafe24-com
◆ Model alias (optional)
│ e.g. local, ollama
이후 나머지 단계는 초기 설정 가이드의 기본 흐름과 동일합니다.
3-8. 용도별 모델 추천
Model ID에 어떤 모델을 넣을지 고민된다면 아래 추천을 참고하세요. (실제 사용 가능 모델은 LLM Router 모델 목록에서 확인)
| 용도 | 추천 모델 |
|---|---|
| 일반 작업 (최고 효율 · 무료 크레딧 기반 작업 가능) | DeepSeek-V4-Flash (기본 선택) · gpt-oss-120b · NVIDIA-Nemotron-3-Super-120B-A12B |
| 멀티모달 · 이미지/문서 이해 (효율) | gemini-3.5-flash |
| 코딩 · 고급 작업 | claude-sonnet-4-6 · claude-opus-4-8 · DeepSeek-V4-Pro · Kimi-K2.6 · GLM-5.2 |
처음에는 DeepSeek-V4-Flash 같은 고효율 모델로 시작해 무료 크레딧으로 충분히 테스트한 뒤, 코딩·고급 작업이 필요할 때 claude-sonnet-4-6·claude-opus-4-8 등으로 바꾸는 것을 권장합니다.
모델 변경 · 메신저 추가 등 운영 단계는 운영 가이드를, LLM Router 크레딧 충전 · 사용 현황은 LLM Router 가이드를 참고하세요.