메인 콘텐츠로 건너뛰기
Cloudflare AI Gateway는 제공자 API 앞단에 위치하며 분석, 캐싱, 제어 기능을 추가할 수 있게 해줍니다. Anthropic의 경우 OpenClaw는 Gateway 엔드포인트를 통해 Anthropic Messages API를 사용합니다.
속성값
제공자cloudflare-ai-gateway
기본 URLhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
기본 모델cloudflare-ai-gateway/claude-sonnet-4-6
API 키CLOUDFLARE_AI_GATEWAY_API_KEY (Gateway를 통한 요청에 사용하는 제공자 API 키)
Cloudflare AI Gateway를 통해 라우팅되는 Anthropic 모델에는 Anthropic API 키를 제공자 키로 사용하세요.
Anthropic Messages 모델에서 thinking이 활성화된 경우, OpenClaw는 Cloudflare AI Gateway를 통해 페이로드를 보내기 전에 끝에 붙은 assistant 사전 채움 턴을 제거합니다. Anthropic은 확장 thinking에서 응답 사전 채우기를 거부하지만, 일반적인 비-thinking 사전 채우기는 계속 사용할 수 있습니다.

​
Plugin 설치

공식 Plugin을 설치한 다음 Gateway를 다시 시작합니다. 
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

​
시작하기

1

제공자 API 키와 Gateway 세부 정보 설정

온보딩을 실행하고 Cloudflare AI Gateway 인증 옵션을 선택합니다.
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
계정 ID, gateway ID, API 키를 입력하라는 메시지가 표시됩니다.
2

기본 모델 설정

OpenClaw 구성에 모델을 추가합니다.
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

모델을 사용할 수 있는지 확인

openclaw models list --provider cloudflare-ai-gateway

​
비대화형 예시

스크립트나 CI 설정에서는 모든 값을 명령줄에 전달합니다. 
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에서 Gateway 인증을 활성화했다면 cf-aig-authorization 헤더를 추가하세요. 이는 제공자 API 키에 추가로 필요합니다.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
cf-aig-authorization 헤더는 Cloudflare Gateway 자체에 인증하고, 제공자 API 키(예: Anthropic 키)는 업스트림 제공자에 인증합니다.
Gateway가 데몬(launchd/systemd)으로 실행되는 경우 CLOUDFLARE_AI_GATEWAY_API_KEY를 해당 프로세스에서 사용할 수 있는지 확인하세요.
대화형 셸에서만 내보낸 키는 해당 환경도 그곳에 가져오지 않는 한 launchd/systemd 데몬에는 도움이 되지 않습니다. gateway 프로세스가 키를 읽을 수 있도록 ~/.openclaw/.env 또는 env.shellEnv를 통해 키를 설정하세요.

​
관련 항목

모델 선택

제공자, 모델 참조, 장애 조치 동작 선택.

문제 해결

일반적인 문제 해결 및 FAQ.