Volcengine（Doubao）

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

# はじめに

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

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

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

# Providers とエンドポイント

# 組み込みカタログ

# テキスト読み上げ

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 を設定してください。

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

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

# 高度な設定

# 関連