SGLang

SGLang 通过与 OpenAI 兼容的 HTTP API 提供开放权重模型。OpenClaw 使用 openai-completions 提供商系列连接到 SGLang，并自动发现可用模型。

属性	值
提供商 ID	`sglang`
插件	内置，`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 通常运行于：

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 转换为模型条目。

如果显式设置 models.providers.sglang，OpenClaw 默认使用你声明的模型。如果希望 OpenClaw 查询所配置提供商的 /models 端点并包含其公布的所有 SGLang 模型，请将 "sglang/*": {} 添加到 agents.defaults.models。

显式配置（手动模型）

在以下情况下使用显式配置：

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 兼容的 /v1 后端，而非原生 OpenAI 端点。

行为	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 设置任意非空值，即可选择启用模型发现。

模型选择

选择提供商、模型引用和故障转移行为。

配置参考

完整的配置架构，包括提供商条目。

概览

模型概念

提供商

入门指南

模型发现（隐式提供商）

显式配置（手动模型）

高级配置

相关内容

模型选择

配置参考

​入门指南

​模型发现（隐式提供商）

​显式配置（手动模型）

​高级配置

​相关内容

模型选择

配置参考

入门指南

模型发现（隐式提供商）

显式配置（手动模型）

高级配置

相关内容