Chuyển đến nội dung chính
Cloudflare AI Gateway nằm phía trước API của nhà cung cấp và cho phép bạn thêm phân tích, bộ nhớ đệm và các biện pháp kiểm soát. Với Anthropic, OpenClaw dùng Anthropic Messages API thông qua điểm cuối Gateway của bạn.
Thuộc tínhGiá trị
Nhà cung cấpcloudflare-ai-gateway
URL cơ sởhttps://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Model mặc địnhcloudflare-ai-gateway/claude-sonnet-4-6
Khóa APICLOUDFLARE_AI_GATEWAY_API_KEY (khóa API nhà cung cấp của bạn cho các yêu cầu đi qua Gateway)
Với các model Anthropic được định tuyến qua Cloudflare AI Gateway, hãy dùng khóa API Anthropic của bạn làm khóa nhà cung cấp.
Khi bật suy luận cho các model Anthropic Messages, OpenClaw loại bỏ các lượt điền sẵn trợ lý ở cuối trước khi gửi payload qua Cloudflare AI Gateway. Anthropic từ chối điền sẵn phản hồi khi dùng suy luận mở rộng, trong khi điền sẵn thông thường không suy luận vẫn khả dụng.

​
Cài đặt Plugin

Cài đặt Plugin chính thức, rồi khởi động lại Gateway: 
openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

​
Bắt đầu

1

Set the provider API key and Gateway details

Chạy onboarding và chọn tùy chọn xác thực Cloudflare AI Gateway:
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
Lệnh này sẽ hỏi ID tài khoản, ID gateway và khóa API của bạn.
2

Set a default model

Thêm model vào cấu hình OpenClaw của bạn:
{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}
3

Verify the model is available

openclaw models list --provider cloudflare-ai-gateway

​
Ví dụ không tương tác

Với thiết lập bằng script hoặc CI, truyền tất cả giá trị trên dòng lệnh: 
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"

​
Cấu hình nâng cao

Nếu bạn đã bật xác thực Gateway trong Cloudflare, hãy thêm header cf-aig-authorization. Đây là phần bổ sung ngoài khóa API nhà cung cấp của bạn.
{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}
Header cf-aig-authorization xác thực với chính Cloudflare Gateway, còn khóa API nhà cung cấp (ví dụ: khóa Anthropic của bạn) xác thực với nhà cung cấp thượng nguồn.
Nếu Gateway chạy như một daemon (launchd/systemd), hãy bảo đảm CLOUDFLARE_AI_GATEWAY_API_KEY khả dụng cho tiến trình đó.
Khóa chỉ được export trong shell tương tác sẽ không giúp ích cho daemon launchd/systemd trừ khi môi trường đó cũng được nhập vào đó. Đặt khóa trong ~/.openclaw/.env hoặc qua env.shellEnv để bảo đảm tiến trình gateway có thể đọc được.

​
Liên quan

Model selection

Chọn nhà cung cấp, tham chiếu model và hành vi chuyển đổi dự phòng.

Troubleshooting

Khắc phục sự cố chung và câu hỏi thường gặp.