OpenClaw 한국어 문서

Appearance

Cloudflare AI Gateway ​

Cloudflare AI Gateway는 프로바이더 API 앞에 위치하여 분석, 캐싱, 제어 기능을 추가합니다. Anthropic의 경우 OpenClaw는 게이트웨이 엔드포인트를 통해 Anthropic Messages API를 사용합니다.

  • 프로바이더: cloudflare-ai-gateway
  • 기본 URL: https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
  • 기본 모델: cloudflare-ai-gateway/claude-sonnet-4-5
  • API 키: CLOUDFLARE_AI_GATEWAY_API_KEY (게이트웨이를 통한 요청에 사용하는 프로바이더 API 키)

Anthropic 모델의 경우 Anthropic API 키를 사용하십시오.

빠른 시작 ​

  1. 프로바이더 API 키 및 게이트웨이 세부 정보 설정:
bash
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
  1. 기본 모델 설정:
json5
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
    },
  },
}

비대화형 예시 ​

bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY"

인증된 게이트웨이 ​

Cloudflare에서 게이트웨이 인증을 활성화한 경우 cf-aig-authorization 헤더를 추가하십시오 (프로바이더 API 키에 추가).

json5
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}

환경 참고 사항 ​

게이트웨이가 데몬(launchd/systemd)으로 실행되는 경우, CLOUDFLARE_AI_GATEWAY_API_KEY가 해당 프로세스에서 사용 가능한지 확인하십시오 (예: ~/.openclaw/.env 또는 env.shellEnv를 통해).