본문으로 건너뛰기

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 서비스에 가입해야 합니다.

  1. 카페24 LLM Router에 접속합니다.
  2. 카페24 호스팅 회원으로 로그인합니다. (호스팅 회원이 아니라면 먼저 회원가입)
  3. 약관 동의 후 아이디(신규 자아이디 또는 비어있는 기존 자아이디)를 선택하고 신청 완료합니다.

신청이 완료되면 즉시 ₩1,000 무료 크레딧이 지급되어 바로 사용할 수 있습니다. 가입 시점에 카드 등록은 필요 없습니다.

가입 절차·무료 크레딧·연령 제한 등 자세한 내용은 LLM Router 가입하기 가이드를 참고하세요.


2. API 키 생성

OpenClaw 연결에는 API 키Base URL이 필요합니다. LLM Router 콘솔에서 발급합니다.

  1. LLM Router 콘솔에서 API 키 관리 메뉴로 이동합니다.
  2. 키 이름 · 크레딧 한도 · 만료일을 설정하고 키를 생성합니다.
  3. 생성된 API 키 값을 복사해 안전한 곳에 보관합니다.
  4. 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 가이드를 참고하세요.