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

Volcengine(Doubao)

Volcengine プロバイダーは、Volcano Engine 上でホストされる Doubao モデルおよびサードパーティモデルへのアクセスを提供し、一般用途とコーディング用途で別々のエンドポイントを備えています。
DetailValue
プロバイダーvolcengine(一般) + volcengine-plan(コーディング)
認証VOLCANO_ENGINE_API_KEY
APIOpenAI互換

はじめに

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"

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

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

利用可能なモデル

Model refNameInputContext
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8テキスト、画像256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028テキスト、画像256,000
volcengine/kimi-k2-5-260127Kimi K2.5テキスト、画像256,000
volcengine/glm-4-7-251222GLM 4.7テキスト、画像200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2テキスト、画像128,000

高度な注記

openclaw onboard --auth-choice volcengine-api-key は現在、 volcengine-plan/ark-code-latest をデフォルトモデルに設定しつつ、 一般向けの volcengine カタログも登録します。
オンボーディング / 設定時のモデル選択では、Volcengine の認証方法は volcengine/*volcengine-plan/* の両方の行を優先します。これらのモデルが まだ読み込まれていない場合、OpenClaw は空のプロバイダースコープ付きピッカーを表示するのではなく、 フィルターなしカタログにフォールバックします。
Gateway がデーモン(launchd/systemd)として実行される場合は、 VOLCANO_ENGINE_API_KEY がそのプロセスから利用可能であることを確認してください(たとえば ~/.openclaw/.env または env.shellEnv 経由)。
OpenClaw をバックグラウンドサービスとして実行する場合、対話シェルで設定した環境変数は 自動的には引き継がれません。上記のデーモンに関する注記を参照してください。

関連

モデル選択

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

Configuration

エージェント、モデル、プロバイダーに関する完全な config リファレンス。

トラブルシューティング

一般的な問題とデバッグ手順。

FAQ

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