Gateway AI của Cloudflare

Cloudflare AI Gateway nằm phía trước các API của nhà cung cấp và bổ sung khả năng phân tích, lưu vào bộ nhớ đệm cùng các biện pháp kiểm soát. Đối với Anthropic, OpenClaw sử dụng Anthropic Messages API thông qua điểm cuối Gateway của bạn.

Thuộc tính	Giá trị
Nhà cung cấp	cloudflare-ai-gateway
Plugin	gói bên ngoài chính thức (@openclaw/cloudflare-ai-gateway-provider)
URL cơ sở	https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Mô hình mặc định	cloudflare-ai-gateway/claude-sonnet-4-6
Khóa API	CLOUDFLARE_AI_GATEWAY_API_KEY (khóa API của nhà cung cấp dùng cho các yêu cầu thông qua Gateway)

Đối với các mô hình 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 chế độ suy luận được bật cho các mô hình Anthropic Messages, OpenClaw loại bỏ các lượt điền trước cuối cùng của trợ lý trước khi gửi tải trọng qua Cloudflare AI Gateway. Anthropic từ chối việc điền trước phản hồi khi bật chế độ suy luận mở rộng, trong khi tính năng điền trước thông thường không dùng chế độ suy luận vẫn khả dụng.

​

Cài đặt Plugin

Cài đặt Plugin chính thức, sau đó khởi động lại Gateway:

openclaw plugins install @openclaw/cloudflare-ai-gateway-provider
openclaw gateway restart

​

Bắt đầu

1. Đặt khóa API của nhà cung cấp và thông tin Gateway

   Chạy quy trình thiết lập ban đầu và chọn tùy chọn xác thực Cloudflare AI Gateway:

   openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
   

   Thao tác này sẽ yêu cầu ID tài khoản, ID gateway và khóa API của bạn.

2. Đặt mô hình mặc định

   Thêm mô hình vào cấu hình OpenClaw của bạn:

   {
     agents: {
       defaults: {
         model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
       },
     },
   }
   
3. Xác minh mô hình khả dụng

   openclaw models list --provider cloudflare-ai-gateway
   

​

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

Đối với thiết lập bằng tập lệnh hoặc CI, hãy 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

Gateway có xác thực

Nếu bạn đã bật tính năng xác thực Gateway trong Cloudflare, hãy thêm tiêu đề cf-aig-authorization. Tiêu đề này được dùng ngoài khóa API của nhà cung cấp.

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}

Tiêu đề cf-aig-authorization dùng để xác thực với chính Cloudflare Gateway, còn khóa API của nhà cung cấp (ví dụ: khóa Anthropic của bạn) dùng để xác thực với nhà cung cấp thượng nguồn.

Lưu ý về môi trường

Nếu Gateway chạy dưới dạng daemon (launchd/systemd), hãy bảo đảm tiến trình đó có thể truy cập CLOUDFLARE_AI_GATEWAY_API_KEY.

Khóa chỉ được xuất trong shell tương tác sẽ không có tác dụng với daemon launchd/systemd, trừ khi môi trường đó cũng được nhập vào daemon. Hãy đặt khóa trong ~/.openclaw/.env hoặc thông qua env.shellEnv để bảo đảm tiến trình gateway có thể đọc khóa.

​

Nội dung liên quan

Lựa chọn mô hình

Cách chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.

Khắc phục sự cố

Hướng dẫn khắc phục sự cố chung và các câu hỏi thường gặp.