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:

openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

​

Bắt đầu

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

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

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

   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.

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

   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.

Bạn chỉ cần ghi đè models.providers.qianfan khi cần URL cơ sở hoặc siêu dữ liệu mô hình tùy chỉnh.

​

Ví dụ cấu hình

{
  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,
          },
        ],
      },
    },
  },
}

Tham chiếu mô hình sử dụng tiền tố qianfan/ (ví dụ: qianfan/deepseek-v3.2).

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.