Skip to main content
SGLang 通过 OpenAI 兼容的 HTTP API 提供开放权重模型。OpenClaw 使用 openai-completions 提供商家族连接到 SGLang，并自动发现可用模型。
属性值
提供商 idsglang
插件内置，enabledByDefault: true
凭证环境变量SGLANG_API_KEY（如果服务器没有凭证，使用任何非空值）
新手引导标志--auth-choice sglang
APIOpenAI 兼容（openai-completions）
默认基础 URLhttp://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/* 来保持动态发现。请参阅下方的 模型发现（隐式提供商）。

​
入门指南

1

启动 SGLang

使用 OpenAI 兼容服务器启动 SGLang。你的基础 URL 应公开 /v1 端点（例如 /v1/models、/v1/chat/completions）。SGLang 通常运行在：
  • http://127.0.0.1:30000/v1
2

设置 API key

如果你的服务器未配置凭证，任何值都可用：
export SGLANG_API_KEY="sglang-local"
3

运行新手引导或直接设置模型

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 key（或你想控制标头）。
{
  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 的任何非空值都足以选择启用模型发现。

​
相关内容

模型选择

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

配置参考

完整配置 schema，包括提供商条目。