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:

openclaw plugins install @openclaw/qianfan-provider
openclaw 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ą

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

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.

Wartość models.providers.qianfan trzeba nadpisać tylko wtedy, gdy potrzebujesz niestandardowego bazowego adresu URL lub metadanych modelu.

Przykład konfiguracji

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

Odwołania do modeli używają prefiksu qianfan/ (na przykład qianfan/deepseek-v3.2).

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.

Overview

Concepts and configuration

Providers

Instalacja Pluginu

Pierwsze kroki

Wbudowany katalog

Przykład konfiguracji

Powiązane materiały

Wybór modelu

Dokumentacja konfiguracji

Konfiguracja agenta

Dokumentacja API Qianfan

​Instalacja Pluginu

​Pierwsze kroki

​Wbudowany katalog

​Przykład konfiguracji

​Powiązane materiały

Wybór modelu

Dokumentacja konfiguracji

Konfiguracja agenta

Dokumentacja API Qianfan

Instalacja Pluginu

Pierwsze kroki

Wbudowany katalog

Przykład konfiguracji

Powiązane materiały