メインコンテンツへスキップ
SGLang は OpenAI 互換の HTTP API 経由でオープンウェイトモデルを提供します。OpenClaw は、利用可能なモデルの自動検出付きで openai-completions プロバイダーファミリーを使用して SGLang に接続します。
プロパティ値
プロバイダー idsglang
Pluginバンドル済み、enabledByDefault: true
認証 env varSGLANG_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

Start SGLang

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

Set an API key

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

Run onboarding or set a model directly

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、プロンプトキャッシュヒント送信されない
reasoning 互換ペイロード整形適用されない
隠し属性ヘッダー（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 に任意の空でない値を設定すれば モデル検出にオプトインできます。

​
関連

Model selection

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

Configuration reference

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