Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Dostawca Volcengine zapewnia dostęp do modeli Doubao i modeli zewnętrznych hostowanych w Volcano Engine, z oddzielnymi punktami końcowymi dla ogólnych i programistycznych obciążeń. Ten sam dołączony Plugin może również zarejestrować Volcengine Speech jako dostawcę TTS.
SzczegółWartość
Dostawcyvolcengine (ogólne + TTS) + volcengine-plan (kodowanie)
Uwierzytelnianie modeliVOLCANO_ENGINE_API_KEY
Uwierzytelnianie TTSVOLCENGINE_TTS_API_KEY lub BYTEPLUS_SEED_SPEECH_API_KEY
APIModele zgodne z OpenAI, BytePlus Seed Speech TTS

​
Pierwsze kroki

1

Ustaw klucz API

Uruchom interaktywne wdrażanie:
openclaw onboard --auth-choice volcengine-api-key
Spowoduje to zarejestrowanie zarówno ogólnego dostawcy (volcengine), jak i dostawcy do kodowania (volcengine-plan) przy użyciu jednego klucza API.
2

Ustaw model domyślny

{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}
3

Sprawdź, czy model jest dostępny

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
W przypadku konfiguracji nieinteraktywnej (CI, skrypty) przekaż klucz bezpośrednio:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
Dostawcy i punkty końcowe

DostawcaPunkt końcowyPrzypadek użycia
volcengineark.cn-beijing.volces.com/api/v3Modele ogólne
volcengine-planark.cn-beijing.volces.com/api/coding/v3Modele do kodowania
Obaj dostawcy są konfigurowani za pomocą jednego klucza API. Konfiguracja rejestruje obu automatycznie.

​
Wbudowany katalog

Odwołanie do modeluNazwaWejścieKontekst
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8tekst, obraz256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028tekst, obraz256,000
volcengine/kimi-k2-5-260127Kimi K2.5tekst, obraz256,000
volcengine/glm-4-7-251222GLM 4.7tekst, obraz200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2tekst, obraz128,000

​
Zamiana tekstu na mowę

Volcengine TTS używa interfejsu HTTP API BytePlus Seed Speech i jest konfigurowany oddzielnie od klucza API modeli Doubao zgodnego z OpenAI. W konsoli BytePlus otwórz Seed Speech > Settings > API Keys i 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 to w 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,
        },
      },
    },
  },
}
W przypadku miejsc docelowych dla notatek głosowych OpenClaw prosi Volcengine o natywny dla dostawcy format ogg_opus. W przypadku zwykłych załączników audio prosi o mp3. Aliasy dostawcy bytedance i doubao również wskazują tego samego dostawcę mowy. Domyślny identyfikator zasobu to seed-tts-1.0, ponieważ właśnie taki BytePlus przyznaje nowo utworzonym kluczom API Seed Speech w projekcie domyślnym. Jeśli Twój projekt ma uprawnienie TTS 2.0, ustaw VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
VOLCANO_ENGINE_API_KEY służy do punktów końcowych modeli ModelArk/Doubao i nie jest kluczem API Seed Speech. TTS wymaga klucza API Seed Speech z konsoli BytePlus Speech Console albo starszej pary AppID/token z Speech Console.
Starsze uwierzytelnianie AppID/token nadal jest 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"

​
Konfiguracja zaawansowana

openclaw onboard --auth-choice volcengine-api-key obecnie ustawia volcengine-plan/ark-code-latest jako model domyślny, jednocześnie rejestrując ogólny katalog volcengine.
Podczas wdrażania/konfiguracji wyboru modelu opcja uwierzytelniania Volcengine preferuje wiersze volcengine/* i volcengine-plan/*. Jeśli te modele nie są jeszcze załadowane, OpenClaw wraca do niefiltrowanego katalogu zamiast wyświetlać pusty selektor ograniczony do dostawcy.
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 oraz VOLCENGINE_TTS_TOKEN, są dostępne dla tego procesu (na przykład w ~/.openclaw/.env lub przez env.shellEnv).
Podczas uruchamiania OpenClaw jako usługi w tle zmienne środowiskowe ustawione w interaktywnej powłoce nie są automatycznie dziedziczone. Zobacz powyższą uwagę dotyczącą demona.

​
Powiązane

Wybór modelu

Wybór dostawców, odwołań do modeli i zachowania awaryjnego.

Konfiguracja

Pełna dokumentacja konfiguracji agentów, modeli i dostawców.

Rozwiązywanie problemów

Typowe problemy i kroki debugowania.

FAQ

Często zadawane pytania dotyczące konfiguracji OpenClaw.