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 で有効にします。

{  tts: {    auto: "always",    provider: "volcengine",    providers: {      volcengine: {        apiKey: "byteplus_seed_speech_api_key",        voice: "en_female_anna_mars_bigtts",        speedRatio: 1.0,      },    },  },}

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 があり、設定されている場合は対応する tts.providers.volcengine 設定フィールドを上書きします。

高度な設定

関連情報