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

​
はじめに

1

API キーを設定する

対話形式のオンボーディングを実行します。
これにより、1 つの API キーから一般用（volcengine）とコーディング用（volcengine-plan）の両プロバイダーが登録されます。
2

デフォルトモデルを設定する

3

モデルが利用可能であることを確認する

非対話形式のセットアップ（CI、スクリプト処理）では、キーを直接渡します。

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

両プロバイダーは、1 つの API キーから設定されます。セットアップ時に両方が自動的に登録され、コーディングプロバイダーのモデル選択でも一般プロバイダーの認証が再利用されます（volcengine-plan は volcengine の認証エイリアスです）。

​
組み込みカタログ

両カタログは静的であり（/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 キーをコピーしてから、次のように設定します。
次に、openclaw.json で有効にします。
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 を設定します。
VOLCANO_ENGINE_API_KEY は ModelArk/Doubao モデルエンドポイント用であり、Seed Speech API キーではありません。TTS には、BytePlus Speech Console から取得した Seed Speech API キー、または従来の Speech Console AppID/トークンのペアが必要です。
古い Speech Console アプリケーション向けに、従来の AppID/トークン認証も引き続きサポートされています。
その他のオプションの TTS 環境変数として、VOLCENGINE_TTS_VOICE、VOLCENGINE_TTS_APP_KEY、および VOLCENGINE_TTS_BASE_URL があり、設定されている場合は対応する tts.providers.volcengine 設定フィールドを上書きします。

​
高度な設定

openclaw onboard --auth-choice volcengine-api-key は、一般用の volcengine カタログも登録しながら、volcengine-plan/ark-code-latest をデフォルトモデルとして設定します。
オンボーディングまたは設定時のモデル選択において、Volcengine の認証選択では volcengine/* と volcengine-plan/* の両方の行が優先されます。これらのモデルがまだ読み込まれていない場合、OpenClaw はプロバイダーに絞り込まれた空のモデル選択画面を表示せず、フィルターされていないカタログにフォールバックします。
Gateway がデーモン（launchd/systemd）として実行される場合は、VOLCANO_ENGINE_API_KEY、VOLCENGINE_TTS_API_KEY、BYTEPLUS_SEED_SPEECH_API_KEY、VOLCENGINE_TTS_APPID、VOLCENGINE_TTS_TOKEN などのモデルおよび TTS の環境変数を、そのプロセスから利用できるようにしてください（たとえば、~/.openclaw/.env 内、または env.shellEnv 経由）。
OpenClaw をバックグラウンドサービスとして実行する場合、対話型シェルで設定した環境変数は自動的に継承されません。前述のデーモンに関する注記を参照してください。

​
関連情報

モデルの選択

プロバイダー、モデル参照、およびフェイルオーバー動作の選択について説明します。

設定

エージェント、モデル、およびプロバイダーの完全な設定リファレンスです。

トラブルシューティング

一般的な問題とデバッグ手順について説明します。

よくある質問

OpenClaw のセットアップに関するよくある質問です。