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:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartPierwsze 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-keyW 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 qianfanWbudowany 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
{ 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
Wybieranie dostawców, odwołań do modeli i sposobu działania przełączania awaryjnego.
Pełna dokumentacja konfiguracji OpenClaw.
Konfigurowanie ustawień domyślnych agenta i przypisań modeli.
Oficjalna dokumentacja API Qianfan.
