Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Bắt đầu

1

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

Chạy quy trình giới thiệu 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
Lệnh 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

Với các thiết lập dạng script hoặc CI, hãy truyền mọi 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. Điều này bổ sung cho 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, trong khi 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 dưới dạng daemon (launchd/systemd), hãy bảo đảm CLOUDFLARE_AI_GATEWAY_API_KEY khả dụng cho tiến trình đó.
Một khóa chỉ nằm trong ~/.profile 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 thông qua env.shellEnv để bảo đảm tiến trình gateway có thể đọc được khóa.

​
Liên quan

Lựa chọn mô hình

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ố

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