Providers
Cloudflare AI Gateway
Cloudflare AI Gateway는 제공자 API 앞단에 위치하며 분석, 캐싱, 제어 기능을 추가할 수 있게 해줍니다. Anthropic의 경우 OpenClaw는 Gateway 엔드포인트를 통해 Anthropic Messages API를 사용합니다.
| 속성 | 값 |
|---|---|
| 제공자 | cloudflare-ai-gateway |
| 기본 URL | https://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 키) |
Anthropic Messages 모델에서 thinking이 활성화된 경우, OpenClaw는 Cloudflare AI Gateway를 통해 페이로드를 보내기 전에 끝에 붙은 assistant 사전 채움 턴을 제거합니다. Anthropic은 확장 thinking에서 응답 사전 채우기를 거부하지만, 일반적인 비-thinking 사전 채우기는 계속 사용할 수 있습니다.
Plugin 설치
공식 Plugin을 설치한 다음 Gateway를 다시 시작합니다.
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw gateway restart시작하기
제공자 API 키와 Gateway 세부 정보 설정
온보딩을 실행하고 Cloudflare AI Gateway 인증 옵션을 선택합니다.
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key계정 ID, gateway ID, API 키를 입력하라는 메시지가 표시됩니다.
기본 모델 설정
OpenClaw 구성에 모델을 추가합니다.
{ agents: { defaults: { model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" }, }, },}모델을 사용할 수 있는지 확인
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>", }, }, }, },}환경 참고
Gateway가 데몬(launchd/systemd)으로 실행되는 경우 CLOUDFLARE_AI_GATEWAY_API_KEY를 해당 프로세스에서 사용할 수 있는지 확인하세요.
관련 항목
Was this useful?
