LangBot 接入 Models Hub:添加模型与知识库配置
在 LangBot 里新增指向 Models Hub 的模型,配置好流水线后即可在飞书、钉钉、微信、QQ 等平台使用,附推荐模型、知识库嵌入模型与常见报错排查。
LangBot 是一个开源的即时通信机器人开发平台,支持飞书、钉钉、微信、QQ、Telegram、Discord、Slack 等主流 IM 平台,并内置知识库、Agent、MCP 等能力。它支持接入任意 OpenAI 兼容的模型服务,把模型指向 Models Hub 后,绑定到流水线的机器人对话都会用 Models Hub 的额度。本文只讲接入,流水线搭建见官方文档。
三样东西
接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com/v1、一个模型名。
准备
- 已部署 LangBot。下载地址:GitHub Releases。项目地址:GitHub。
- 一个 Models Hub API Key。在控制台的 令牌页 创建,令牌所在分组要能访问你打算用的模型。
推荐模型
| 用途 | 模型名 | 定价 | 实时状态 |
|---|---|---|---|
| 日常对话首选,速度与质量的平衡点 | claude-sonnet-4-6 | 查看价格 | 可用率与延迟 |
| 复杂推理与长上下文 | gpt-5.5 | 查看价格 | 可用率与延迟 |
| 便宜快速,适合高频群聊问答 | gpt-5.4-mini | 查看价格 | 可用率与延迟 |
模型名以 模型定价页 为准。
配置步骤
-
在 Models Hub 控制台的 令牌页 获取 API Key。若使用本地部署的 LangBot,请自行确认容器网络能访问到 Models Hub 地址(参考 LangBot 容器网络连接文档)。
-
在 LangBot 后台进入模型管理,新增模型时选择 OpenAI 兼容类型的供应商(⚠️ 具体选项名称以你当前版本列表里实际看到的为准),填入 API Key 与 API 地址
https://modelsok.com/v1。
-
进入流水线配置,把对话模型选择为刚添加的模型。
验证
在 LangBot 的对话调试页发一句「你好」,或直接跟绑定到流水线的机器人(如飞书、微信)对话,能正常回复即接通。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求,确认走的是 Models Hub。部署机器人的具体步骤见 LangBot 部署文档。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 新增模型时提示连接失败 | API 地址填错,或本地部署时容器网络不通 | 第三方站点用 https://modelsok.com/v1;本地部署参考容器网络连接文档排查 |
401 / Invalid API key | Key 复制不完整,或令牌被禁用 | 到 令牌页 重新复制 |
| 流水线里选不到模型 / 对话报模型不存在 | 模型名拼错,或令牌所在分组没有该模型 | 对照 定价页 核对名字 |
回复很慢或报 429 | 触发限流,通常是并发过高 | 稍后重试;持续出现联系客服提额 |
| 用量日志里没有记录 | 流水线的对话模型没有切换成新添加的模型 | 回到流水线配置确认对话模型选中正确 |
更多排查见 故障排查。
常见问题
计费方式? 按每次对话实际消耗的输入与输出 token 计费,价格看各模型定价页,用量日志里能看到每条请求的明细。
和直接用 OpenAI 官方接口有什么区别? 请求格式一致,只是把地址换成了 Models Hub。
怎么切换模型? 在模型管理里新增或编辑模型,再回到流水线配置切换对话模型。
能用 Models Hub 的嵌入模型做知识库吗? 可以。LangBot 支持在新增嵌入模型时选择同一个 OpenAI 兼容供应商,建知识库时选用该嵌入模型即可,详见官方文档。