메인 콘텐츠로 건너뛰기
Capriole AI API 키 하나로 OpenClaw에서 GPT-6.2 Astra, Claude Fable 5.1, Opus 5.5, Gemini 4 Carbon 모델을 공식 API 가격보다 최대 92% 저렴하게 사용할 수 있습니다.

OpenClaw란

OpenClaw는 오픈 소스 셀프 호스팅 개인 AI 어시스턴트이자 게이트웨이입니다. WhatsApp, Slack, Discord, Telegram, iMessage, WebChat 같은 채팅 채널을 AI 에이전트에 연결합니다. 이 구성은 Capriole AI를 사용자 지정 모델 제공자 세 개로 추가하며, 각 제공자는 Capriole AI가 제공하는 API 프로토콜 하나에 대응합니다.

사전 준비

시작하기 전에 다음이 있는지 확인하세요.
  • Capriole AI 계정(여기에서 가입)
  • Premium 플랜(월 USD 9, 무제한 웹 채팅 포함) 또는 Team 플랜. API 키를 만들려면 둘 중 하나가 필요합니다(구독하기)
  • Capriole AI API 키(키 받기)

설치

공식 설치 스크립트로 OpenClaw를 설치하세요.
그런 다음 OpenClaw 자체 설정을 완료하세요.

구성

모델 검증

OpenClaw 2026.4.21 버전은 아래 구성으로 지원 모델 섹션의 모든 모델에서 Capriole AI를 통한 파일 읽기, 파일 쓰기, 최종 답변 검사를 통과합니다. 아래의 models 블록과 agents.defaults 모델 설정을 ~/.openclaw/openclaw.json에 추가하세요. openclaw onboard가 작성한 다른 설정은 그대로 두세요.
각 설정의 역할은 다음과 같습니다.
  • capriole-ai-openai는 GPT 모델을 Responses API로 보냅니다. capriole-ai-anthropic은 Claude 모델을 Anthropic Messages로 보냅니다. capriole-ai-compatible은 Gemini, Grok, GLM, Kimi 모델을 Chat Completions로 보냅니다.
  • ${CAPRIOLE_AI_API_KEY}는 환경 변수에서 키를 읽습니다.
  • authorization-bearer를 지정한 request.auth는 Anthropic 제공자가 키를 Bearer 토큰으로 보내게 합니다.
  • OpenClaw가 /v1/messages를 직접 추가하므로 Anthropic baseUrl에는 /v1이 없습니다.
  • Opus 5.5의 reasoning은 false입니다. true이면 OpenClaw가 추론 예산을 보내고, Opus 5.5는 requires adaptive thinking으로 이를 거부합니다.
  • contextWindow와 maxTokens는 OpenClaw에 각 모델의 한도를 알려 줍니다.
  • agents.defaults.models는 에이전트가 사용할 수 있는 모델 목록입니다. agents.defaults.model.primary는 기본 모델입니다.

OpenClaw 실행

OpenClaw를 시작하는 모든 터미널에서 키를 내보내세요.
게이트웨이를 시작하세요.
다른 터미널에서 터미널 UI를 여세요.
게이트웨이 없이 로컬에서 일회성으로 실행하려면 다음을 사용하세요.

지원 모델

모델 참조는 <provider-id>/<model-id> 형식을 사용합니다. openai-latest, claude-latest, google-latest는 항상 각 계열의 최신 플래그십 모델을 가리킵니다. 현재는 GPT-6.2 Astra, Claude Fable 5.1, Gemini 4 Carbon입니다.

문제 해결

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

openclaw gateway 또는 openclaw agent를 시작하는 터미널에서 CAPRIOLE_AI_API_KEY를 내보내세요. 변수가 설정되지 않으면 OpenClaw는 missing env var를 출력합니다.

Opus 5.5가 requires adaptive thinking으로 실패하는 이유는 무엇인가요?

claude-opus-5-5의 reasoning을 false로 설정하세요.

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

openclaw models list를 실행하세요. 모델 참조가 agents.defaults.models에 있는지, 모델 항목에 id와 name만이 아니라 위에 표시된 전체 객체가 있는지 확인하세요.

새 세션이 설정 대화로 시작하는 이유는 무엇인가요?

이는 Capriole AI 문제가 아니라 OpenClaw의 첫 실행 작업 공간 설정입니다. openclaw tui에서 한 번 완료하거나 openclaw onboard를 다시 실행하세요.

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

openclaw status, openclaw gateway status, openclaw logs --follow, openclaw doctor를 실행하세요.

참고

마지막 수정일 2026년 11월 18일