Providers 导读

SGLang 接入:自动发现模型 vs 手动配置,选错会跳过发现

SGLang 跑在本地,OpenClaw 通过 OpenAI 兼容接口连接。最省事的是设个 SGLANG_API_KEY(任意值),然后让 OpenClaw 自动拉模型列表;一旦你在配置里显式写了 models.providers.sglang,自动发现就失效,必须手动填模型 ID 和参数。注意:基础 URL 必须暴露 /v1 端点,默认端口 30000。

先讲这一页到底在解决什么

SGLang 接入:自动发现模型 vs 手动配置,选错会跳过发现

SGLang 跑在本地,OpenClaw 通过 OpenAI 兼容接口连接。最省事的是设个 SGLANG_API_KEY(任意值),然后让 OpenClaw 自动拉模型列表;一旦你在配置里显式写了 models.providers.sglang,自动发现就失效,必须手动填模型 ID 和参数。注意:基础 URL 必须暴露 /v1 端点,默认端口 30000。

原文共 6 节,先看 Start Here 路径:/providers/sglang 查看官方原文

第一步

🚪 先确认你的 SGLang 服务器门口带着 /v1

和 Ollama 正好相反,这里官方就是要你走带 /v1 的那扇门。

http://127.0.0.1:30000/v1

像 SGLang 这栋小楼的常见门牌号。

/v1/models

像门口的大厅目录牌,OpenClaw 可以去这里看今天有哪些模型在岗。

/v1/chat/completions

像真正办业务的窗口,聊天请求会从这里进去。

第二步

🪪 SGLANG_API_KEY 有时更像“进门贴纸”,哪怕只是随便写一个值

官方说得很实用:如果你的服务器没强制鉴权,任何值都能当 opt-in 信号。

🏷

export SGLANG_API_KEY="sglang-local"

像在门口贴一张“请启用 SGLang”小纸条,不一定是真的保安钥匙。

🧭

openclaw onboard

像让带路老师自动去探测这台小楼里有哪些老师能上班。

🧠

sglang/your-model-id

像选定目录牌上某位老师,告诉 OpenClaw 默认就找他。

第三步

📚 自动发现和手写配置,像“看大厅目录”与“自己做座位表”

两种都能走,区别只是你要不要自己把模型资料填死。

自动发现

像前台直接去 /v1/models 抄今天在岗名单,最省事。

显式配置

像你自己做座位表,把 contextWindowmaxTokens 这些信息手写进去。

curl /v1/models

像站在门口问一句:“今天到底谁在楼里值班?”

🎈 什么时候用手写配置

当门牌号不是默认值、你想固定上下文长度,或者服务器确实要真 key 时,就自己做座位表。

最后总结

🎈 把 SGLang 这页压成一句最好记的话

SGLang 像自建模型小楼。你先确认它的 /v1 门口能通,再决定是让 OpenClaw 自动看目录,还是你自己手写一张模型座位表。

如果你也在用 Ollama,记住两者最大的反差:SGLang 要带 /v1,Ollama 反而别带。