Skip to main content

OpenClaw란

OpenClaw는 WhatsApp, Slack, Discord, Telegram, iMessage, WebChat 같은 채팅 채널을 AI 에이전트에 연결하는 오픈 소스 셀프호스트 개인 AI 어시스턴트이자 게이트웨이입니다. 사용자 지정 OpenAI 호환 및 Anthropic 호환 모델 제공자를 구성해 Capriole AI를 통해 지원 모델 요청을 보낼 수 있습니다.

사전 준비

시작하기 전에 다음이 있는지 확인하세요.

설치

구성

GPT 제공자를 구성하세요.
Claude, Grok, GLM, Kimi Chat Completions 제공자를 구성하세요.
Anthropic 제공자를 구성하세요.
기본 에이전트에 구성한 Capriole AI 모델을 허용하세요.

OpenClaw 실행

게이트웨이를 시작하세요.
다른 터미널에서 TUI를 여세요.

지원 모델

OpenClaw는 Capriole AI를 통해 OpenAI latest, GPT 5.6 Thinking, GPT 5.6, GPT 5.5, GPT 5.4 mini, Fable 5, Opus 5, Grok 4.5, GLM 5.2, Kimi K3, Claude latest, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6을 지원합니다. Fable 5와 Opus 5는 Chat Completions 호환 제공자 또는 Anthropic Messages 제공자를 사용할 수 있습니다.
  • openai-latest
  • openai/gpt-5.6-terra
  • openai/gpt-5.6-luna
  • openai/gpt-5.5
  • openai/gpt-5.4-mini
  • anthropic/claude-fable-5
  • anthropic/claude-opus-5
  • xai/grok-4.5
  • zai/glm-5.2
  • moonshot/kimi-k3
  • claude-latest
  • claude-fable-5
  • claude-opus-5
  • claude-opus-4-8
  • claude-opus-4-7
  • claude-opus-4-6
  • claude-sonnet-4-6

문제 해결

GPT 요청이 실패하는 이유는 무엇인가요?

models.providers.capriole-ai-openai.api"openai-responses"이고 baseUrlhttps://api.caprioletech.com/v1인지 확인하세요.

Grok, GLM, Kimi 요청이 실패하는 이유는 무엇인가요?

models.providers.capriole-ai-compatible.api"openai-completions"이고 baseUrlhttps://api.caprioletech.com/v1인지 확인하세요.

Anthropic 요청이 실패하는 이유는 무엇인가요?

models.providers.capriole-ai-anthropic.api"anthropic-messages"이고 Anthropic baseUrl/v1 없는 https://api.caprioletech.com인지 확인하세요.

인증이 실패하는 이유는 무엇인가요?

openclaw gateway를 시작하는 터미널과 openclaw tui를 시작하는 터미널에서 CUSTOM_API_KEY를 내보내세요.

OpenClaw가 모델이 허용되지 않거나 사용할 수 없다고 하는 이유는 무엇인가요?

openclaw models list를 실행한 다음, 선택한 모델과 agents.defaults.models 허용 목록에 capriole-ai-openai/openai-latest, capriole-ai-compatible/xai/grok-4.5, capriole-ai-compatible/moonshot/kimi-k3, capriole-ai-anthropic/claude-latest 같은 Capriole AI 모델 참조가 포함되어 있는지 확인하세요. Capriole AI 모델이 누락된 것으로 보이면 위에 나온 전체 객체로 모델 항목을 업데이트하세요. 현재 OpenClaw 릴리스는 사용자 지정 제공자 모델에 idname 이상이 필요합니다.

게이트웨이가 시작되지 않는 이유는 무엇인가요?

openclaw status, openclaw gateway status, openclaw logs --follow, openclaw doctor를 실행하세요. 다시 시도하기 전에 스키마, gateway.mode, 서비스 문제를 해결하세요.

포트 18789가 실패하는 이유는 무엇인가요?

다른 로컬 포트를 선택하고 게이트웨이와 클라이언트 구성에 같은 포트를 사용하세요. 서비스 모드 설치에서는 포트를 바꾼 뒤 openclaw doctor --fix 또는 openclaw gateway install --force를 실행하세요.

참고

  • OpenClaw 사용자 지정 제공자는 제공자 API 모드가 Capriole AI 엔드포인트 계열과 일치해야 합니다.
  • OpenClaw 2026.4.21은 openai-completions를 통해 Grok 4.5, GLM 5.2, Kimi K3로 로컬 exec 도구 워크플로를 완료합니다.
  • Capriole AI는 모델 요청을 처리합니다. OpenClaw는 게이트웨이, 채널, 에이전트 설정으로 최종 assistant 동작을 계속 형성할 수 있습니다.
  • 공식 참고: OpenClaw install, OpenClaw custom providers, OpenClaw model providers, OpenClaw troubleshooting.
마지막 수정일 2026년 8월 18일