Cloudflare AI Gateway
Cloudflare AI Gateway 是 Cloudflare 提供的 AI API 代理网关，可以为你的 AI API 请求添加缓存、速率限制、日志记录和分析功能。
工作原理
Cloudflare AI Gateway 作为一个反向代理（Reverse Proxy），位于你的应用和 AI 提供商之间：
OpenClaw → Cloudflare AI Gateway → OpenAI / Anthropic / 其他提供商配置步骤
第一步：创建 Gateway
- 登录 Cloudflare Dashboard
- 进入「AI」>「AI Gateway」
- 创建一个新的 Gateway
- 记录 Gateway ID 和 Account ID
第二步：配置 OpenClaw
将 AI 提供商的 baseUrl 修改为 Cloudflare AI Gateway 的地址：
jsonc
// ~/.openclaw/config.json
{
"models": {
"providers": {
"openai": {
"apiKey": "sk-xxxxxxxx",
"baseUrl": "https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/openai"
}
}
}
}支持的提供商
| 提供商 | Gateway URL 路径 |
|---|---|
| OpenAI | /openai |
| Anthropic | /anthropic |
| Hugging Face | /huggingface |
| Azure OpenAI | /azure-openai |
功能特性
请求缓存
相同请求会被缓存，降低 API 成本并加速响应。
速率限制
可以设置每分钟、每小时的请求上限，防止意外超额。
日志与分析
所有请求的详细日志和使用分析，方便监控和调试。
回退策略（Fallback）
当主提供商不可用时，自动切换到备用提供商。
故障排查
Gateway 连接失败
- 确认 Gateway ID 和 Account ID 正确
- 检查 Cloudflare Dashboard 中 Gateway 是否正常运行
请求被拒绝
- 检查速率限制设置
- 确认 API Key 有效
🇨🇳 中国用户须知
- 加速访问：Cloudflare 的全球 CDN 网络可能在一定程度上改善中国大陆访问国际 AI API 的稳定性
- 注意：Cloudflare AI Gateway 本身仍需要从中国大陆配置代理访问
- 企业方案：Cloudflare 企业版可能提供更好的中国大陆访问体验