メインコンテンツへスキップ
Volcengine プロバイダーは、Volcano Engine でホストされる Doubao モデルとサードパーティモデルへのアクセスを提供し、汎用ワークロードとコーディングワークロード向けに別々のエンドポイントを備えています。同じバンドル済み Plugin は、Volcengine Speech も TTS プロバイダーとして登録します。
詳細値
プロバイダーvolcengine (汎用 + TTS), volcengine-plan (コーディング)
モデル認証VOLCANO_ENGINE_API_KEY
TTS 認証VOLCENGINE_TTS_API_KEY または BYTEPLUS_SEED_SPEECH_API_KEY
APIOpenAI 互換モデル、BytePlus Seed Speech TTS

​
はじめに

1

API キーを設定する

対話型オンボーディングを実行します。
openclaw onboard --auth-choice volcengine-api-key
これにより、1 つの API キーから汎用 (volcengine) とコーディング (volcengine-plan) の両方のプロバイダーが登録されます。
2

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

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

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

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
非対話型セットアップ (CI、スクリプト) では、キーを直接渡します。
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

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

プロバイダーエンドポイントユースケース
volcengineark.cn-beijing.volces.com/api/v3汎用モデル
volcengine-planark.cn-beijing.volces.com/api/coding/v3コーディングモデル
両方のプロバイダーは 1 つの API キーから設定されます。セットアップでは両方が自動的に登録され、コーディングプロバイダーのモデルピッカーも汎用プロバイダーの認証を再利用します (volcengine-plan は volcengine の認証エイリアスです)。

​
組み込みカタログ

モデル参照名前入力コンテキスト
volcengine/deepseek-v3-2-251201DeepSeek V3.2text, image128,000
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8text, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028text, image256,000
volcengine/glm-4-7-251222GLM 4.7text, image200,000
volcengine/kimi-k2-5-260127Kimi K2.5text, image256,000
どちらのカタログも静的 (/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 を設定します。
VOLCANO_ENGINE_API_KEY は ModelArk/Doubao モデルエンドポイント用であり、Seed Speech API キーではありません。TTS には BytePlus Speech Console の Seed Speech API キー、またはレガシーの Speech Console AppID/token ペアが必要です。
レガシーの AppID/token 認証は、古い Speech Console アプリケーション向けに引き続きサポートされています。 
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 設定フィールドを上書きします。

​
高度な設定

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 をバックグラウンドサービスとして実行する場合、対話型シェルで設定された環境変数は自動的には継承されません。上記のデーモンに関する注記を参照してください。

​
関連

モデル選択

プロバイダー、モデル参照、フェイルオーバー動作の選択。

設定

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

トラブルシューティング

よくある問題とデバッグ手順。

FAQ

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