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.models で sglang/* を使用すると、検出を動的に維持できます。以下のモデル検出（暗黙的プロバイダー）を参照してください。
はじめに
SGLang を起動する
OpenAI 互換サーバーで SGLang を起動します。ベース URL は
/v1 エンドポイント（例：/v1/models、/v1/chat/completions）を公開する必要があります。SGLang は
一般的に次の URL で実行されます。
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、プロンプトキャッシュのヒント |
送信されない |
| 推論互換ペイロードの整形 | 適用されない |
非表示の帰属ヘッダー（originator、version、User-Agent） |
カスタムの SGLang ベース URL には挿入されない |
トラブルシューティング
サーバーに到達できない
サーバーが実行中で応答していることを確認します。
curl http://127.0.0.1:30000/v1/models認証エラー
リクエストが認証エラーで失敗する場合は、サーバー設定に一致する実際の
SGLANG_API_KEY を設定するか、models.providers.sglang で
プロバイダーを明示的に設定します。
