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

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.

SGLang は、OpenAI 互換の HTTP API 経由でオープンウェイトモデルを提供します。OpenClaw は、利用可能なモデルの自動検出付きで openai-completions プロバイダーファミリーを使用して SGLang に接続します。
プロパティ値
プロバイダー IDsglang
Pluginバンドル済み、enabledByDefault: true
認証環境変数SGLANG_API_KEY (サーバーに認証がない場合は任意の空でない値)
オンボーディングフラグ--auth-choice sglang
APIOpenAI 互換 (openai-completions)
デフォルトのベース URLhttp://127.0.0.1:30000/v1
デフォルトモデルのプレースホルダーsglang/Qwen/Qwen3-8B
ストリーミング使用量はい (supportsStreamingUsage: true)
価格外部無料としてマーク (modelPricing.external: false)
OpenClaw は、SGLANG_API_KEY でオプトインした場合、SGLang から利用可能なモデルも自動検出します。カスタム SGLang ベース URL も設定する場合は、agents.defaults.models で sglang/* を使用して検出を動的なままにします。下のモデル検出 (暗黙のプロバイダー)を参照してください。

​
はじめに

1

SGLang を起動する

OpenAI 互換サーバーで SGLang を起動します。ベース URL は /v1 エンドポイント (例: /v1/models, /v1/chat/completions) を公開している必要があります。SGLang は 通常、次で実行されます。
  • http://127.0.0.1:30000/v1
2

API キーを設定する

サーバーに認証が設定されていない場合は、任意の値で動作します。
export SGLANG_API_KEY="sglang-local"
3

オンボーディングを実行するか、モデルを直接設定する

openclaw onboard
または、モデルを手動で設定します。
{
  agents: {
    defaults: {
      model: { primary: "sglang/your-model-id" },
    },
  },
}

​
モデル検出 (暗黙のプロバイダー)

SGLANG_API_KEY が設定されている (または認証プロファイルが存在する) かつ models.providers.sglang を定義していない場合、OpenClaw は次をクエリします。
  • GET http://127.0.0.1:30000/v1/models
そして、返された ID をモデルエントリに変換します。
models.providers.sglang を明示的に設定した場合、OpenClaw はデフォルトで宣言済みの モデルを使用します。OpenClaw にその設定済みプロバイダーの /models エンドポイントをクエリさせ、 公開されているすべての SGLang モデルを含めたい場合は、agents.defaults.models に "sglang/*": {} を追加します。

​
明示的な設定 (手動モデル)

次の場合は明示的な設定を使用します。
  • SGLang が別のホスト/ポートで実行されている。
  • contextWindow/maxTokens 値を固定したい。
  • サーバーが実際の API キーを必要とする (またはヘッダーを制御したい)。
{
  models: {
    providers: {
      sglang: {
        baseUrl: "http://127.0.0.1:30000/v1",
        apiKey: "${SGLANG_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "your-model-id",
            name: "Local SGLang Model",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

​
高度な設定

SGLang はネイティブな OpenAI エンドポイントではなく、プロキシスタイルの OpenAI 互換 /v1 バックエンドとして扱われます。
動作SGLang
OpenAI 専用のリクエスト整形適用されません
service_tier、Responses store、プロンプトキャッシュヒント送信されません
推論互換ペイロード整形適用されません
隠し帰属ヘッダー (originator, version, User-Agent)カスタム SGLang ベース URL には注入されません
サーバーに到達できないサーバーが実行中で応答していることを確認します。
curl http://127.0.0.1:30000/v1/models
認証エラーリクエストが認証エラーで失敗する場合は、サーバー設定と一致する実際の SGLANG_API_KEY を設定するか、 models.providers.sglang の下でプロバイダーを明示的に設定します。
SGLang を認証なしで実行している場合、SGLANG_API_KEY には空でない任意の値を設定すれば、 モデル検出にオプトインするには十分です。

​
関連

モデル選択

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

設定リファレンス

プロバイダーエントリを含む完全な設定スキーマ。