Cloudflare AI Gateway란
Cloudflare AI Gateway는 Cloudflare가 제공하는 AI 요청 프록시 서비스로, 애플리케이션과 AI 공급자 사이에서 중간 레이어 역할을 하며 캐싱, 속도 제한, 로그 기록 및 비용 관리 기능을 제공합니다. OpenClaw을 Cloudflare AI Gateway에 연결하면 더 나은 요청 관측성과 비용 최적화 기능을 얻을 수 있습니다.
사전 준비
- Cloudflare 계정 (무료 플랜 가능)
- Cloudflare Dashboard에서 AI Gateway 생성 완료
- 설치 및 실행 중인 OpenClaw 인스턴스
- 업스트림 모델 공급자 API Key (예: OpenAI)
OpenClaw에서 설정
모델 공급자의 base URL을 Cloudflare AI Gateway 엔드포인트로 교체합니다:
{
"providers": {
"cloudflare-openai": {
"type": "openai",
"baseUrl": "https://gateway.ai.cloudflare.com/v1/your_account_id/your_gateway/openai",
"apiKey": "{{OPENAI_API_KEY}}",
"models": ["gpt-4o", "gpt-4o-mini"]
}
}
}
다중 공급자 지원
{
"providers": {
"cf-openai": {
"type": "openai",
"baseUrl": "https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway}/openai"
},
"cf-anthropic": {
"type": "anthropic",
"baseUrl": "https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway}/anthropic"
}
}
}
캐싱 활성화
Cloudflare AI Gateway는 동일 요청에 대한 캐싱을 지원하여 API 호출 비용을 절감합니다. Gateway 설정 페이지에서 Caching 기능을 활성화하세요.
속도 제한 설정
예상치 못한 고빈도 요청으로 인한 비용 급증을 방지하려면 AI Gateway에서 속도 제한 규칙을 설정하세요.
로그 및 모니터링
Cloudflare AI Gateway는 모든 요청 로그를 자동으로 기록합니다. Dashboard에서 요청 총수, 토큰 사용량, 응답 지연 분포, 오류 요청 상세 정보 등을 확인할 수 있습니다.
장애 해결
설정 후 모델이 정상적으로 응답하지 않는 경우:
- URL 형식이 올바른지 확인: Gateway URL 끝에 올바른 공급자 식별자(예:
/openai)가 포함되어야 합니다 - API Key 유효성 확인: Cloudflare AI Gateway는 API Key를 업스트림 공급자에 전달합니다
- 네트워크 연결성 확인: OpenClaw 서버가 Cloudflare 도메인에 접근할 수 있는지 확인하세요
openclaw doctor --provider cloudflare-openai
정리
Cloudflare AI Gateway는 OpenClaw에 강력한 중간 프록시 레이어를 제공하며, 핵심 코드 수정 없이 캐싱, 속도 제한, 로그 등 엔터프라이즈급 기능을 활용할 수 있습니다. base URL만 변경하면 되므로, AI 요청을 정밀하게 관리해야 하는 팀에 적합합니다.