Memoh 接入 Models Hub:添加模型提供商
在 Memoh 的 Web 管理面板里添加 NewAPI 提供商并指向 Models Hub,配置机器人默认聊天模型,附推荐模型与常见报错排查。
Memoh 是一个开源的自托管 AI 智能体平台,每个机器人运行在独立容器中,拥有持久化记忆,支持 Telegram、Discord、飞书、QQ、企业微信、微信、邮件等 9 种渠道。它的提供商管理内置了 NewAPI 预设,专门兼容基于开源项目 new-api 构建的网关服务——Models Hub 正是用这套网关搭建的,选它接入即可。本文只讲接入,Memoh 的容器化、记忆引擎等能力见官方文档。
三样东西
接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com/v1、一个模型名。
准备
-
已部署 Memoh。基于 Docker 一键安装(需要 Docker):
curl -fsSL https://memoh.sh | sudo sh启动后访问
http://localhost:8082,默认账号密码admin/admin123,首次登录请立即修改密码。项目地址:GitHub。 -
一个 Models Hub API Key。在控制台的 令牌页 创建,令牌所在分组要能访问你打算用的模型。
推荐模型
| 用途 | 模型名 | 定价 | 实时状态 |
|---|---|---|---|
| 日常对话首选,速度与质量的平衡点 | claude-sonnet-4-6 | 查看价格 | 可用率与延迟 |
| 复杂推理与长上下文 | gpt-5.5 | 查看价格 | 可用率与延迟 |
| 便宜快速,适合高频渠道问答 | gpt-5.4-mini | 查看价格 | 可用率与延迟 |
模型名以 模型定价页 为准。
配置步骤
-
在 Models Hub 注册登录后,点顶部「控制台」→「令牌管理」→「添加令牌」创建 API Key,点复制按钮复制。
-
登录 Memoh Web 管理面板,进入提供商管理页面,点击 NewAPI。
-
在配置页面填写:
字段 填什么 API Base URL https://modelsok.com/v1(本地部署的 Models Hub 填http://localhost:3000/v1)API Key 你刚复制的 Models Hub API Key 点击保存。
-
提供商配置完成后,进入模型管理页面,点自动导入或手动添加上面推荐的模型名。
-
进入机器人设置页面,在模型配置一栏把默认聊天模型切换为刚添加的模型,点保存。
验证
在 Memoh 的 Web UI 或已绑定的渠道(如 Telegram、飞书)里发一句「你好」,能正常回复即接通。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求,确认走的是 Models Hub。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 保存提供商时提示连接失败 | API Base URL 写错,或本地部署时用了容器外无法访问的地址 | 第三方站点用 https://modelsok.com/v1;本地部署确认容器网络可达 |
401 / Invalid API key | Key 复制不完整,或令牌被禁用 | 到 令牌页 重新复制 |
| 模型管理页导入不到模型 / 对话报模型不存在 | 模型名拼错,或令牌所在分组没有该模型 | 手动添加时对照 定价页 核对名字 |
回复很慢或报 429 | 触发限流,通常是并发过高 | 稍后重试;持续出现联系客服提额 |
| 用量日志里没有记录 | 机器人的默认聊天模型没有切换成新添加的模型 | 回到机器人设置页面确认模型配置正确 |
更多排查见 故障排查。
常见问题
计费方式? 按每次对话实际消耗的输入与输出 token 计费,价格看各模型定价页,用量日志里能看到每条请求的明细。
为什么提供商叫 NewAPI 而不是 Models Hub? NewAPI 是 Memoh 内置的供应商类型名,对应它兼容的网关协议,不代表某个具体站点;Models Hub 的接入地址与 Key 填进去即可。
怎么切换模型? 回到机器人设置页面的模型配置一栏,选择模型管理里已导入的其它模型。