Providers

Gateway AI của Cloudflare

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ính Giá trị
Nhà cung cấp cloudflare-ai-gateway
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 nhà cung cấp của bạn cho các yêu cầu thông qua Gateway)

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

  • Đặ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.

  • Đặ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" },
        },
      },
    }
    
  • 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

    Gateway đã xác thực

    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>",
            },
          },
        },
      },
    }
    
    Ghi chú về môi trường

    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 đó.

    Liên quan