メインコンテンツへスキップ

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.

Volcengine provider は、一般用途およびコーディング用途で分かれたエンドポイントを通じて、Volcano Engine 上でホストされる Doubao models とサードパーティ models へのアクセスを提供します。同じバンドル済みPluginで、Volcengine Speech を TTS provider として登録することもできます。
DetailValue
Providersvolcengine（一般 + TTS）+ volcengine-plan（コーディング）
Model authVOLCANO_ENGINE_API_KEY
TTS authVOLCENGINE_TTS_API_KEY または BYTEPLUS_SEED_SPEECH_API_KEY
APIOpenAI互換 models、BytePlus Seed Speech TTS

​
はじめに

1

API キーを設定する

対話式オンボーディングを実行します:
openclaw onboard --auth-choice volcengine-api-key
これにより、1つの API キーから一般用の provider（volcengine）とコーディング用の provider（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"

​
Providers とエンドポイント

ProviderEndpointUse case
volcengineark.cn-beijing.volces.com/api/v3一般モデル
volcengine-planark.cn-beijing.volces.com/api/coding/v3コーディングモデル
両方の provider は 1 つの API キーから設定されます。セットアップでは両方が自動的に登録されます。

​
組み込みカタログ

Model refNameInputContext
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8text, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028text, image256,000
volcengine/kimi-k2-5-260127Kimi K2.5text, image256,000
volcengine/glm-4-7-251222GLM 4.7text, image200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2text, image128,000

​
テキスト読み上げ

Volcengine TTS は BytePlus Seed Speech HTTP API を使用し、OpenAI互換の Doubao model API キーとは別に設定されます。BytePlus console で 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,
        },
      },
    },
  },
}
voice-note ターゲットでは、OpenClaw は provider ネイティブの ogg_opus を Volcengine に要求します。通常の音声添付では mp3 を要求します。provider aliases の bytedance と doubao も同じ speech provider に解決されます。 デフォルトの resource id は seed-tts-1.0 です。これは BytePlus がデフォルト project 内で新規作成された Seed Speech API キーに付与する値だからです。project に TTS 2.0 entitlement がある場合は、VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 を設定してください。
VOLCANO_ENGINE_API_KEY は ModelArk/Doubao model エンドポイント用であり、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"

​
高度な設定

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

​
関連

モデル選択

Providers、model refs、およびフェイルオーバー動作の選び方。

設定

エージェント、models、providers の完全な設定リファレンス。

トラブルシューティング

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

FAQ

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