Providers

SGLang

SGLang は OpenAI 互換の HTTP API 経由でオープンウェイトモデルを提供します。OpenClaw は openai-completions プロバイダーファミリーを使用し、利用可能なモデルを自動検出して SGLang に接続します。

プロパティ
プロバイダー ID sglang
Plugin バンドル済み、enabledByDefault: true
認証環境変数 SGLANG_API_KEY (サーバーに認証がない場合は任意の空でない値)
オンボーディングフラグ --auth-choice sglang
API OpenAI 互換 (openai-completions)
デフォルトのベース URL http://127.0.0.1:30000/v1
デフォルトモデルのプレースホルダー sglang/Qwen/Qwen3-8B
ストリーミング使用量 はい (supportsStreamingUsage: true)
料金 外部無料としてマーク (modelPricing.external: false)

また、OpenClaw は SGLANG_API_KEY でオプトインし、明示的な models.providers.sglang エントリを定義していない場合、SGLang から利用可能なモデルを自動検出します。下記の モデル検出 (暗黙的プロバイダー) を参照してください。

はじめに

  • SGLang を起動する

    OpenAI 互換サーバーで SGLang を起動します。ベース URL は /v1 エンドポイント (たとえば /v1/models/v1/chat/completions) を公開している必要があります。SGLang は 一般的に次で実行されます。

    • http://127.0.0.1:30000/v1
  • API キーを設定する

    サーバーで認証が設定されていない場合は、任意の値で動作します。

    export SGLANG_API_KEY="sglang-local"
    
  • オンボーディングを実行するか、モデルを直接設定する

    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 をモデルエントリに変換します。

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

    次の場合は明示的な設定を使用します。

    • 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、プロンプトキャッシュヒント 送信されません
    推論互換ペイロード整形 適用されません
    非表示の帰属ヘッダー (originatorversionUser-Agent) カスタム SGLang ベース URL には注入されません
    トラブルシューティング

    サーバーに到達できない

    サーバーが実行中で応答していることを確認します。

    curl http://127.0.0.1:30000/v1/models
    

    認証エラー

    リクエストが認証エラーで失敗する場合は、サーバー設定と一致する実際の SGLANG_API_KEY を設定するか、 models.providers.sglang の下でプロバイダーを明示的に設定します。

    関連