Providers
Volcengine (Doubao)
Dostawca Volcengine zapewnia dostęp do modeli Doubao i modeli innych firm hostowanych w Volcano Engine, z oddzielnymi punktami końcowymi dla obciążeń ogólnych i programistycznych. Ten sam wbudowany Plugin rejestruje również Volcengine Speech jako dostawcę TTS.
| Szczegół | Wartość |
|---|---|
| Dostawcy | volcengine (ogólny + TTS), volcengine-plan (programowanie) |
| Uwierzytelnianie modeli | VOLCANO_ENGINE_API_KEY |
| Uwierzytelnianie TTS | VOLCENGINE_TTS_API_KEY lub BYTEPLUS_SEED_SPEECH_API_KEY |
| API | Modele zgodne z OpenAI, TTS BytePlus Seed Speech |
Pierwsze kroki
Ustaw klucz API
Uruchom interaktywną konfigurację początkową:
openclaw onboard --auth-choice volcengine-api-keySpowoduje to zarejestrowanie zarówno dostawcy ogólnego (volcengine), jak i programistycznego (volcengine-plan) przy użyciu jednego klucza API.
Ustaw model domyślny
{ agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" }, }, },}Sprawdź dostępność modelu
openclaw models list --provider volcengineopenclaw models list --provider volcengine-planDostawcy i punkty końcowe
| Dostawca | Punkt końcowy | Zastosowanie |
|---|---|---|
volcengine |
ark.cn-beijing.volces.com/api/v3 |
Modele ogólne |
volcengine-plan |
ark.cn-beijing.volces.com/api/coding/v3 |
Modele programistyczne |
Wbudowany katalog
Ogólne (volcengine)
| Odwołanie do modelu | Nazwa | Dane wejściowe | Kontekst |
|---|---|---|---|
volcengine/deepseek-v3-2-251201 |
DeepSeek V3.2 | tekst, obraz | 128,000 |
volcengine/doubao-seed-1-8-251228 |
Doubao Seed 1.8 | tekst, obraz | 256,000 |
volcengine/doubao-seed-code-preview-251028 |
doubao-seed-code-preview-251028 | tekst, obraz | 256,000 |
volcengine/glm-4-7-251222 |
GLM 4.7 | tekst, obraz | 200,000 |
volcengine/kimi-k2-5-260127 |
Kimi K2.5 | tekst, obraz | 256,000 |
Programowanie (volcengine-plan)
| Odwołanie do modelu | Nazwa | Dane wejściowe | Kontekst |
|---|---|---|---|
volcengine-plan/ark-code-latest |
Plan programistyczny Ark | tekst | 256,000 |
volcengine-plan/doubao-seed-code |
Doubao Seed Code | tekst | 256,000 |
volcengine-plan/doubao-seed-code-preview-251028 |
Wersja testowa Doubao Seed Code | tekst | 256,000 |
volcengine-plan/glm-4.7 |
GLM 4.7 do programowania | tekst | 200,000 |
volcengine-plan/kimi-k2-thinking |
Kimi K2 Thinking | tekst | 256,000 |
volcengine-plan/kimi-k2.5 |
Kimi K2.5 do programowania | tekst | 256,000 |
Oba katalogi są statyczne (bez wywołania wykrywania /models) i obsługują zgodne z OpenAI rozliczanie użycia w trybie strumieniowym. Schematy narzędzi obu dostawców automatycznie usuwają słowa kluczowe minLength, maxLength, minItems, maxItems, minContains i maxContains, ponieważ API wywołań narzędzi Volcengine je odrzuca.
Zamiana tekstu na mowę
TTS Volcengine korzysta z interfejsu HTTP API BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) i jest konfigurowany niezależnie od klucza API modeli Doubao zgodnego z OpenAI. W konsoli BytePlus otwórz Seed Speech > Settings > API Keys, skopiuj klucz API, a następnie ustaw:
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"Następnie włącz go w pliku openclaw.json:
{ messages: { tts: { auto: "always", provider: "volcengine", providers: { volcengine: { apiKey: "byteplus_seed_speech_api_key", voice: "en_female_anna_mars_bigtts", speedRatio: 1.0, }, }, }, },}Dostępne pola w messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey i baseUrl. Dyrektywa głosu !emotion=<value> również działa w treści, gdy dozwolone jest nadpisywanie ustawień głosu.
W przypadku docelowych wiadomości głosowych OpenClaw żąda natywnego dla dostawcy formatu ogg_opus. W przypadku zwykłych załączników dźwiękowych żąda formatu mp3. Aliasy dostawcy bytedance i doubao również wskazują tego dostawcę syntezy mowy.
Domyślnym identyfikatorem zasobu jest seed-tts-1.0, czyli uprawnienie domyślnie przyznawane przez BytePlus nowo utworzonym kluczom API Seed Speech. Jeśli projekt ma uprawnienie do TTS 2.0, ustaw VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
Starsze uwierzytelnianie za pomocą AppID/tokenu pozostaje obsługiwane w przypadku starszych aplikacji Speech Console:
export VOLCENGINE_TTS_APPID="speech_app_id"export VOLCENGINE_TTS_TOKEN="speech_access_token"export VOLCENGINE_TTS_CLUSTER="volcano_tts"Inne opcjonalne zmienne środowiskowe TTS: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY i VOLCENGINE_TTS_BASE_URL po ustawieniu zastępują odpowiadające im pola konfiguracji messages.tts.providers.volcengine.
Konfiguracja zaawansowana
Model domyślny po konfiguracji początkowej
Polecenie openclaw onboard --auth-choice volcengine-api-key ustawia volcengine-plan/ark-code-latest jako model domyślny, jednocześnie rejestrując ogólny katalog volcengine.
Zachowanie awaryjne selektora modeli
Podczas wyboru modelu w ramach konfiguracji początkowej lub polecenia konfiguracji opcja uwierzytelniania Volcengine preferuje wiersze zarówno volcengine/*, jak i volcengine-plan/*. Jeśli te modele nie zostały jeszcze załadowane, OpenClaw używa niefiltrowanego katalogu zamiast wyświetlać pusty selektor ograniczony do dostawcy.
Zmienne środowiskowe procesów demona
Jeśli Gateway działa jako demon (launchd/systemd), upewnij się, że zmienne środowiskowe modeli i TTS, takie jak VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID i VOLCENGINE_TTS_TOKEN, są dostępne dla tego procesu (na przykład w ~/.openclaw/.env lub za pośrednictwem env.shellEnv).
Powiązane materiały
Wybieranie dostawców, odwołań do modeli i zachowania przy przełączaniu awaryjnym.
Pełna dokumentacja konfiguracji agentów, modeli i dostawców.
Typowe problemy i kroki diagnostyczne.
Często zadawane pytania dotyczące konfiguracji OpenClaw.
