OpenClawDocs
Na tej stronie

Na tej stronie

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

Providers

Qianfan

Qianfan to platforma MaaS firmy Baidu: ujednolicone API zgodne z OpenAI, które kieruje żądania do wielu modeli za pośrednictwem jednego punktu końcowego i klucza API. OpenClaw udostępnia ją jako oficjalny zewnętrzny Plugin @openclaw/qianfan-provider.

Właściwość Wartość
Dostawca qianfan
Uwierzytelnianie QIANFAN_API_KEY
API Zgodne z OpenAI (openai-completions)
Bazowy adres URL https://qianfan.baidubce.com/v2
Domyślny model qianfan/deepseek-v3.2

Instalacja Pluginu

Zainstaluj oficjalny Plugin, a następnie uruchom ponownie Gateway:

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

Pierwsze kroki

  • Utwórz konto Baidu Cloud

    Zarejestruj się lub zaloguj w konsoli Qianfan i upewnij się, że masz włączony dostęp do API Qianfan.

  • Wygeneruj klucz API

    Utwórz nową aplikację lub wybierz istniejącą, a następnie wygeneruj klucz API. Klucze Baidu Cloud mają format bce-v3/ALTAK-....

  • Uruchom konfigurację początkową

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

    W trybie nieinteraktywnym klucz jest odczytywany z --qianfan-api-key <key> lub QIANFAN_API_KEY. Konfiguracja początkowa zapisuje konfigurację dostawcy, dodaje alias QIANFAN dla domyślnego modelu i ustawia qianfan/deepseek-v3.2 jako model domyślny, jeśli nie skonfigurowano żadnego modelu.

  • Sprawdź dostępność modelu

    bash
    openclaw models list --provider qianfan

    • Wbudowany katalog

    Odwołanie do modelu Dane wejściowe Kontekst Maks. dane wyjściowe Rozumowanie Uwagi
    qianfan/deepseek-v3.2 tekst 98,304 32,768 Tak Domyślny model
    qianfan/ernie-5.0-thinking-preview tekst, obraz 119,000 64,000 Tak Wielomodalny

    Katalog jest statyczny; modele nie są wykrywane na żywo.

    Przykład konfiguracji

    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,          },        ],      },    },  },}
    Transport i zgodność

    Qianfan korzysta ze ścieżki transportu zgodnej z OpenAI, a nie z natywnego formatowania żądań OpenAI. Standardowe funkcje zestawu SDK OpenAI działają, ale parametry specyficzne dla dostawcy mogą nie być przekazywane.

    Rozwiązywanie problemów
    • Upewnij się, że klucz API zaczyna się od bce-v3/ALTAK- i ma włączony dostęp do API Qianfan w konsoli Baidu Cloud.
    • Jeśli modele nie są wyświetlane, sprawdź, czy usługa Qianfan jest aktywowana na Twoim koncie.
    • Zmieniaj bazowy adres URL tylko wtedy, gdy używasz niestandardowego punktu końcowego lub serwera proxy.

    Powiązane materiały

    Wybór modelu

    Wybieranie dostawców, odwołań do modeli i sposobu działania przełączania awaryjnego.
    Dokumentacja konfiguracji

    Pełna dokumentacja konfiguracji OpenClaw.
    Konfiguracja agenta

    Konfigurowanie ustawień domyślnych agenta i przypisań modeli.
    Dokumentacja API Qianfan

    Oficjalna dokumentacja API Qianfan.
    Was this useful?