메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 prefill 턴을 제거합니다. Anthropic은 extended thinking과 함께 response prefilling을 거부하지만, 일반적인 non-thinking prefill은 계속 사용할 수 있습니다.

​
시작하기

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를 사용할 수 있는지 확인하세요.
~/.profile에만 있는 키는 해당 환경을 그곳에도 가져오지 않는 한 launchd/systemd 데몬에 도움이 되지 않습니다. Gateway 프로세스가 키를 읽을 수 있도록 ~/.openclaw/.env에 키를 설정하거나 env.shellEnv를 통해 설정하세요.

​
관련 항목

모델 선택

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

문제 해결

일반적인 문제 해결 및 FAQ입니다.