OpenClaw - Capriole AI Docs

OpenClaw란

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

사전 준비

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

Capriole AI 계정(여기에서 가입)
Capriole AI API key(키 받기)

설치

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

구성

모델 검증

OpenClaw 2026.4.21: openai/gpt-6.1-sol, openai/gpt-6-sol, openai/gpt-6-luna, anthropic/claude-fable-5-1, anthropic/claude-opus-5-5, google/gemini-3.8-flash, zai/glm-5.3-flash는 로컬 파일 읽기 도구 및 최종 답변 검사를 통과했습니다. claude-latest는 Fable 5.1로 해석됩니다. 기존 구체 모델 ID도 계속 사용할 수 있습니다. 아래 용량 설정은 GPT-6 Astra, GPT-6.1 Sol, GPT-6 Sol, GPT-6 Luna, Fable 5.1, Opus 5.5, Gemini 3.8 Flash, GLM 5.3 Flash의 공식 사양을 기준으로 합니다. 이는 클라이언트의 모델 용량 설정이며, 요청마다 목표로 하는 출력량이나 검증된 VectorEngine 한도가 아닙니다. 로컬 작업 검사에는 contextWindow=200000과 maxTokens=2048을 사용했으며, 최대 용량 요청은 검증하지 않았습니다. Fable 5.1은 Anthropic Messages 경로 검사도 통과했습니다. xai/grok-4.6는 Chat Completions 요청을 받지만 코딩 에이전트 작업 검사를 통과하지 못해 아래 구성에 포함하지 않습니다. 제공자 직접 검사에서도 Grok 4.5의 도구 사용이 불안정했습니다. API 요청 완료가 올바른 에이전트 답변을 뜻하지는 않습니다. GPT 제공자를 구성하세요.

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
export CAPRIOLE_OPENAI_BASE_URL="https://api.caprioletech.com/v1"

openclaw onboard --non-interactive \
  --accept-risk \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "$CAPRIOLE_OPENAI_BASE_URL" \
  --custom-model-id "openai-latest" \
  --custom-provider-id "capriole-ai-openai" \
  --custom-compatibility openai \
  --secret-input-mode ref \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --skip-channels \
  --skip-search \
  --skip-skills \
  --skip-health \
  --no-install-daemon

openclaw config set models.providers.capriole-ai-openai.request.auth \
  '{"mode":"authorization-bearer","token":"${CUSTOM_API_KEY}"}' \
  --strict-json

openclaw config set models.providers.capriole-ai-openai.api \
  '"openai-responses"' \
  --strict-json

openclaw config set models.providers.capriole-ai-openai.models \
  '[
    {
      "id": "openai-latest",
      "name": "OpenAI latest",
      "api": "openai-responses",
      "contextWindow": 400000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-6-astra",
      "name": "GPT-6 Astra",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-6.1-sol",
      "name": "GPT-6.1 Sol",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-6-sol",
      "name": "GPT-6 Sol",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-6-luna",
      "name": "GPT-6 Luna",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-5.6-terra",
      "name": "GPT 5.6 Thinking",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-5.6-luna",
      "name": "GPT 5.6",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-5.5",
      "name": "GPT 5.5",
      "api": "openai-responses",
      "contextWindow": 400000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    }
  ]' \
  --strict-json

Claude, Grok, GLM, Kimi Chat Completions 제공자를 구성하세요.

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"

openclaw config set models.providers.capriole-ai-compatible \
  '{
    "baseUrl": "https://api.caprioletech.com/v1",
    "apiKey": "${CUSTOM_API_KEY}",
    "api": "openai-completions",
    "models": [
      {
        "id": "anthropic/claude-fable-5-1",
        "name": "Fable 5.1",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "anthropic/claude-fable-5",
        "name": "Fable 5",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "anthropic/claude-opus-5-5",
        "name": "Opus 5.5",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "anthropic/claude-opus-5",
        "name": "Opus 5",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "google/gemini-3.8-flash",
        "name": "Gemini 3.8 Flash",
        "api": "openai-completions",
        "contextWindow": 1048576,
        "maxTokens": 65536,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "xai/grok-4.7",
        "name": "Grok 4.7",
        "api": "openai-completions",
        "contextWindow": 500000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "xai/grok-4.5",
        "name": "Grok 4.5",
        "api": "openai-completions",
        "contextWindow": 500000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "zai/glm-5.3-flash",
        "name": "GLM 5.3 Flash",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "zai/glm-5.2",
        "name": "GLM 5.2",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "moonshot/kimi-k3",
        "name": "Kimi K3",
        "api": "openai-completions",
        "contextWindow": 1048576,
        "maxTokens": 131072,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      }
    ]
  }' \
  --strict-json

Anthropic 제공자를 구성하세요.

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
export CAPRIOLE_ANTHROPIC_BASE_URL="https://api.caprioletech.com"

openclaw onboard --non-interactive \
  --accept-risk \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "$CAPRIOLE_ANTHROPIC_BASE_URL" \
  --custom-model-id "claude-latest" \
  --custom-provider-id "capriole-ai-anthropic" \
  --custom-compatibility anthropic \
  --secret-input-mode ref \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --skip-channels \
  --skip-search \
  --skip-skills \
  --skip-health \
  --no-install-daemon

openclaw config set models.providers.capriole-ai-anthropic.request.auth \
  '{"mode":"authorization-bearer","token":"${CUSTOM_API_KEY}"}' \
  --strict-json

openclaw config set models.providers.capriole-ai-anthropic.api \
  '"anthropic-messages"' \
  --strict-json

openclaw config set models.providers.capriole-ai-anthropic.models \
  '[
    {
      "id": "claude-latest",
      "name": "Claude latest",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-fable-5-1",
      "name": "Fable 5.1",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-fable-5",
      "name": "Fable 5",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-5-5",
      "name": "Opus 5.5",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-5",
      "name": "Opus 5",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-4-8",
      "name": "Opus 4.8",
      "api": "anthropic-messages",
      "contextWindow": 200000,
      "maxTokens": 32000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-4-7",
      "name": "Opus 4.7",
      "api": "anthropic-messages",
      "contextWindow": 200000,
      "maxTokens": 32000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-4-6",
      "name": "Opus 4.6",
      "api": "anthropic-messages",
      "contextWindow": 200000,
      "maxTokens": 32000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-sonnet-4-6",
      "name": "Sonnet 4.6",
      "api": "anthropic-messages",
      "contextWindow": 200000,
      "maxTokens": 32000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    }
  ]' \
  --strict-json

기본 에이전트에 구성한 Capriole AI 모델을 허용하세요.

openclaw config set agents.defaults.models \
  '{"capriole-ai-openai/openai-latest":{},"capriole-ai-openai/openai/gpt-6-astra":{},"capriole-ai-openai/openai/gpt-6.1-sol":{},"capriole-ai-openai/openai/gpt-6-sol":{},"capriole-ai-openai/openai/gpt-6-luna":{},"capriole-ai-openai/openai/gpt-5.6-terra":{},"capriole-ai-openai/openai/gpt-5.6-luna":{},"capriole-ai-openai/openai/gpt-5.5":{},"capriole-ai-compatible/anthropic/claude-fable-5-1":{},"capriole-ai-compatible/anthropic/claude-fable-5":{},"capriole-ai-compatible/anthropic/claude-opus-5-5":{},"capriole-ai-compatible/anthropic/claude-opus-5":{},"capriole-ai-compatible/google/gemini-3.8-flash":{},"capriole-ai-compatible/xai/grok-4.7":{},"capriole-ai-compatible/xai/grok-4.5":{},"capriole-ai-compatible/zai/glm-5.3-flash":{},"capriole-ai-compatible/zai/glm-5.2":{},"capriole-ai-compatible/moonshot/kimi-k3":{},"capriole-ai-anthropic/claude-latest":{},"capriole-ai-anthropic/claude-fable-5-1":{},"capriole-ai-anthropic/claude-fable-5":{},"capriole-ai-anthropic/claude-opus-5-5":{},"capriole-ai-anthropic/claude-opus-5":{},"capriole-ai-anthropic/claude-opus-4-8":{},"capriole-ai-anthropic/claude-opus-4-7":{},"capriole-ai-anthropic/claude-opus-4-6":{},"capriole-ai-anthropic/claude-sonnet-4-6":{}}' \
  --strict-json

OpenClaw 실행

게이트웨이를 시작하세요.

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
openclaw gateway --force --port 18789

다른 터미널에서 TUI를 여세요.

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
openclaw tui

지원 모델

OpenClaw는 Capriole AI를 통해 OpenAI latest, GPT-6 Astra, GPT-6.1 Sol, GPT-6 Sol, GPT-6 Luna, GPT 5.6 Thinking, GPT 5.6, GPT 5.5, Fable 5.1, Fable 5, Opus 5.5, Opus 5, Grok 4.7, Grok 4.5, Gemini 3.8 Flash, GLM 5.3 Flash, 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-6-astra
openai/gpt-6.1-sol
openai/gpt-6-sol
openai/gpt-6-luna
openai/gpt-5.6-terra
openai/gpt-5.6-luna
openai/gpt-5.5
anthropic/claude-fable-5-1
anthropic/claude-fable-5
anthropic/claude-opus-5-5
anthropic/claude-opus-5
google/gemini-3.8-flash
xai/grok-4.7
xai/grok-4.5
zai/glm-5.3-flash
zai/glm-5.2
moonshot/kimi-k3
claude-latest
claude-fable-5-1
claude-fable-5
claude-opus-5-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"이고 baseUrl이 https://api.caprioletech.com/v1인지 확인하세요.

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

models.providers.capriole-ai-compatible.api가 "openai-completions"이고 baseUrl이 https://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 릴리스는 사용자 지정 제공자 모델에 id와 name 이상이 필요합니다.

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

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.

​OpenClaw란

​사전 준비

​설치

​구성

​모델 검증

​OpenClaw 실행

​지원 모델

​문제 해결

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

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

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

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

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

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

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

​참고