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

Providers

Qianfan

Qianfan là nền tảng MaaS của Baidu: một API hợp nhất, tương thích với OpenAI, định tuyến yêu cầu đến nhiều mô hình thông qua một điểm cuối và khóa API duy nhất. OpenClaw cung cấp nền tảng này dưới dạng Plugin bên ngoài chính thức @openclaw/qianfan-provider.

Thuộc tính Giá trị
Nhà cung cấp qianfan
Xác thực QIANFAN_API_KEY
API Tương thích với OpenAI (openai-completions)
URL cơ sở https://qianfan.baidubce.com/v2
Mô hình mặc định qianfan/deepseek-v3.2

Cài đặt Plugin

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

bash
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restart

Bắt đầu

  • Tạo tài khoản Baidu Cloud

    Đăng ký hoặc đăng nhập tại Bảng điều khiển Qianfan và đảm bảo quyền truy cập API Qianfan đã được bật.

  • Tạo khóa API

    Tạo một ứng dụng mới hoặc chọn ứng dụng hiện có, sau đó tạo khóa API. Khóa Baidu Cloud sử dụng định dạng bce-v3/ALTAK-....

  • Chạy quy trình thiết lập ban đầu

    bash
    openclaw onboard --auth-choice qianfan-api-key

    Các lần chạy không tương tác đọc khóa từ --qianfan-api-key <key> hoặc QIANFAN_API_KEY. Quy trình thiết lập ban đầu ghi cấu hình nhà cung cấp, thêm bí danh QIANFAN cho mô hình mặc định và đặt qianfan/deepseek-v3.2 làm mô hình mặc định khi chưa có mô hình nào được cấu hình.

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

    bash
    openclaw models list --provider qianfan

    • Danh mục tích hợp sẵn

    Tham chiếu mô hình Đầu vào Ngữ cảnh Đầu ra tối đa Suy luận Ghi chú
    qianfan/deepseek-v3.2 văn bản 98,304 32,768 Có Mô hình mặc định
    qianfan/ernie-5.0-thinking-preview văn bản, ảnh 119,000 64,000 Có Đa phương thức

    Danh mục này là tĩnh; không có tính năng khám phá mô hình trực tiếp.

    Ví dụ cấu hình

    json5
    {  env: { QIANFAN_API_KEY: "bce-v3/ALTAK-..." },  agents: {    defaults: {      model: { primary: "qianfan/deepseek-v3.2" },      models: {        "qianfan/deepseek-v3.2": { alias: "QIANFAN" },      },    },  },  models: {    providers: {      qianfan: {        baseUrl: "https://qianfan.baidubce.com/v2",        api: "openai-completions",        models: [          {            id: "deepseek-v3.2",            name: "DEEPSEEK V3.2",            reasoning: true,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 98304,            maxTokens: 32768,          },          {            id: "ernie-5.0-thinking-preview",            name: "ERNIE-5.0-Thinking-Preview",            reasoning: true,            input: ["text", "image"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 119000,            maxTokens: 64000,          },        ],      },    },  },}
    Cơ chế truyền tải và khả năng tương thích

    Qianfan hoạt động thông qua đường dẫn truyền tải tương thích với OpenAI, không sử dụng cách định dạng yêu cầu OpenAI nguyên bản. Các tính năng tiêu chuẩn của OpenAI SDK vẫn hoạt động, nhưng các tham số dành riêng cho nhà cung cấp có thể không được chuyển tiếp.

    Khắc phục sự cố
    • Đảm bảo khóa API của bạn bắt đầu bằng bce-v3/ALTAK- và quyền truy cập API Qianfan đã được bật trong bảng điều khiển Baidu Cloud.
    • Nếu các mô hình không được liệt kê, hãy xác nhận tài khoản của bạn đã kích hoạt dịch vụ Qianfan.
    • Chỉ thay đổi URL cơ sở nếu bạn sử dụng điểm cuối hoặc proxy tùy chỉnh.

    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.
    Tham chiếu cấu hình

    Tham chiếu cấu hình OpenClaw đầy đủ.
    Thiết lập tác tử

    Cấu hình giá trị mặc định của tác tử và việc gán mô hình.
    Tài liệu API Qianfan

    Tài liệu API Qianfan chính thức.
    Was this useful?
    On this page

    On this page