OpenClawDocs
ในหน้านี้

ในหน้านี้

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

Providers

Qianfan

Qianfan คือแพลตฟอร์ม MaaS ของ Baidu ซึ่งเป็น API แบบรวมศูนย์ที่เข้ากันได้กับ OpenAI และกำหนดเส้นทางคำขอไปยังโมเดลจำนวนมากผ่านปลายทางและคีย์ API เดียว OpenClaw จัดส่งแพลตฟอร์มนี้ในรูปแบบ Plugin ภายนอกอย่างเป็นทางการ @openclaw/qianfan-provider

คุณสมบัติ ค่า
ผู้ให้บริการ qianfan
การยืนยันตัวตน QIANFAN_API_KEY
API เข้ากันได้กับ OpenAI (openai-completions)
URL ฐาน https://qianfan.baidubce.com/v2
โมเดลเริ่มต้น qianfan/deepseek-v3.2

ติดตั้ง Plugin

ติดตั้ง Plugin อย่างเป็นทางการ แล้วเริ่ม Gateway ใหม่:

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

เริ่มต้นใช้งาน

  • สร้างบัญชี Baidu Cloud

    สมัครหรือลงชื่อเข้าใช้ที่ คอนโซล Qianfan และตรวจสอบว่าได้เปิดใช้สิทธิ์เข้าถึง API ของ Qianfan แล้ว

  • สร้างคีย์ API

    สร้างแอปพลิเคชันใหม่หรือเลือกแอปพลิเคชันที่มีอยู่ แล้วสร้างคีย์ API คีย์ของ Baidu Cloud ใช้รูปแบบ bce-v3/ALTAK-...

  • เรียกใช้การเริ่มต้นระบบ

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

    การเรียกใช้แบบไม่โต้ตอบจะอ่านคีย์จาก --qianfan-api-key <key> หรือ QIANFAN_API_KEY การเริ่มต้นระบบจะเขียนการกำหนดค่าผู้ให้บริการ เพิ่มนามแฝง QIANFAN สำหรับโมเดลเริ่มต้น และตั้งค่า qianfan/deepseek-v3.2 เป็นโมเดลเริ่มต้นเมื่อยังไม่มีการกำหนดค่าโมเดล

  • ตรวจสอบว่าโมเดลพร้อมใช้งาน

    bash
    openclaw models list --provider qianfan

    • แค็ตตาล็อกในตัว

    การอ้างอิงโมเดล อินพุต บริบท เอาต์พุตสูงสุด การให้เหตุผล หมายเหตุ
    qianfan/deepseek-v3.2 ข้อความ 98,304 32,768 ใช่ โมเดลเริ่มต้น
    qianfan/ernie-5.0-thinking-preview ข้อความ, รูปภาพ 119,000 64,000 ใช่ หลายรูปแบบ

    แค็ตตาล็อกเป็นแบบคงที่ และไม่มีการค้นหาโมเดลแบบเรียลไทม์

    ตัวอย่างการกำหนดค่า

    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,          },        ],      },    },  },}
    การรับส่งข้อมูลและความเข้ากันได้

    Qianfan ทำงานผ่านเส้นทางการรับส่งข้อมูลที่เข้ากันได้กับ OpenAI ไม่ใช่การจัดรูปแบบคำขอแบบเนทีฟของ OpenAI คุณลักษณะมาตรฐานของ OpenAI SDK ใช้งานได้ แต่พารามิเตอร์เฉพาะของผู้ให้บริการอาจไม่ถูกส่งต่อ

    การแก้ไขปัญหา
    • ตรวจสอบว่าคีย์ API ของคุณขึ้นต้นด้วย bce-v3/ALTAK- และได้เปิดใช้สิทธิ์เข้าถึง API ของ Qianfan ในคอนโซล Baidu Cloud แล้ว
    • หากไม่มีโมเดลแสดงอยู่ ให้ยืนยันว่าบัญชีของคุณเปิดใช้งานบริการ Qianfan แล้ว
    • เปลี่ยน URL ฐานเฉพาะเมื่อคุณใช้ปลายทางหรือพร็อกซีแบบกำหนดเองเท่านั้น

    เนื้อหาที่เกี่ยวข้อง

    การเลือกโมเดล

    การเลือกผู้ให้บริการ การอ้างอิงโมเดล และลักษณะการทำงานเมื่อสลับไปใช้ระบบสำรอง
    เอกสารอ้างอิงการกำหนดค่า

    เอกสารอ้างอิงการกำหนดค่า OpenClaw ฉบับสมบูรณ์
    การตั้งค่าเอเจนต์

    การกำหนดค่าเริ่มต้นของเอเจนต์และการกำหนดโมเดล
    เอกสาร API ของ Qianfan

    เอกสาร API อย่างเป็นทางการของ Qianfan
    Was this useful?