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

また、SGLANG_API_KEY でオプトインすると、OpenClaw は SGLang から利用可能なモデルを自動検出します。カスタム SGLang ベース URL も設定しつつ検出を動的に保つには、agents.defaults.modelssglang/* を使用します。以下のモデル検出(暗黙的プロバイダー)を参照してください。

はじめに

  • SGLang を起動する

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

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

    サーバーに認証が設定されていない場合は、任意の値を使用できます。

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

    bash
    openclaw onboard

    または、モデルを手動で設定します。

    json5
    {  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 キーが必要である(またはヘッダーを制御したい)。
    json5
    {  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 では挿入されない
    トラブルシューティング

    サーバーに接続できない

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

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

    認証エラー

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

    関連項目

    Was this useful?
    On this page

    On this page