OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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)

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:

bash
openclaw plugins install @openclaw/cloudflare-ai-gateway-provideropenclaw gateway restart

Bắt đầu

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

    bash
    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.

  • Đặt mô hình mặc định

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

    json5
    {  agents: {    defaults: {      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },    },  },}

  • Xác minh mô hình khả dụng

    bash
    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:

    bash
    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.

    json5
    {  models: {    providers: {      "cloudflare-ai-gateway": {        headers: {          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",        },      },    },  },}
    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.

    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.
    Was this useful?
    On this page

    On this page