Volcengine（Doubao）

Volcengine プロバイダーを使用すると、Volcano Engine でホストされている Doubao モデルとサードパーティモデルにアクセスできます。一般用途とコーディング用途では、それぞれ異なるエンドポイントを使用します。同じバンドル済み Plugin により、Volcengine Speech も TTS プロバイダーとして登録されます。

はじめに

openclaw onboard --auth-choice volcengine-api-key

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

openclaw models list --provider volcengineopenclaw models list --provider volcengine-plan

プロバイダーとエンドポイント

組み込みカタログ

どちらのカタログも静的であり（/models 検出呼び出しは行いません）、OpenAI 互換のストリーミング使用量集計をサポートします。Volcengine のツール呼び出し API では受け付けられないため、両プロバイダーのツールスキーマから minLength、maxLength、minItems、maxItems、minContains、maxContains キーワードが自動的に削除されます。

テキスト読み上げ

Volcengine TTS は BytePlus Seed Speech HTTP API（voice.ap-southeast-1.bytepluses.com）を使用し、OpenAI 互換 Doubao モデルの API キーとは別に設定します。BytePlus コンソールで Seed Speech > Settings > API Keys を開き、API キーをコピーしてから、次のように設定します。

export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"

次に、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,        },      },    },  },}

messages.tts.providers.volcengine で使用可能なフィールドは、apiKey、voice、speedRatio（0.2～3.0）、emotion、cluster、resourceId、appKey、baseUrl です。音声設定の上書きが許可されている場合、!emotion=<value> もインライン音声ディレクティブとして機能します。

ボイスメモの送信先では、OpenClaw はプロバイダー固有の ogg_opus を要求します。通常の音声添付ファイルでは、mp3 を要求します。プロバイダーエイリアスの bytedance と doubao も、この音声プロバイダーとして解決されます。

デフォルトのリソース ID は seed-tts-1.0 です。これは、新しく作成された Seed Speech API キーに BytePlus がデフォルトで付与する利用権限です。プロジェクトに TTS 2.0 の利用権限がある場合は、VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 を設定します。

古い Speech Console アプリケーション向けに、従来の AppID/トークン認証も引き続きサポートされています。

export VOLCENGINE_TTS_APPID="speech_app_id"export VOLCENGINE_TTS_TOKEN="speech_access_token"export VOLCENGINE_TTS_CLUSTER="volcano_tts"

その他のオプションの TTS 環境変数として、VOLCENGINE_TTS_VOICE、VOLCENGINE_TTS_APP_KEY、VOLCENGINE_TTS_BASE_URL があります。これらを設定すると、対応する messages.tts.providers.volcengine の設定フィールドが上書きされます。

高度な設定

関連項目