独立部署
面向独立部署实例的总管理员,负责客户账号、配额、模型和版本维护。
1. 总管理后台
打开:
https://<后台域名>/super
使用总管理密码登录。常用入口:
- 系统设置:模型、默认配额、系统更新、管理员密码;
- 授权账户:客户账号、机器人数量、AI Token、到期时间和功能权限;
- 机器人状态:查看机器人在线情况。
2. 客户账号
进入“授权账户”,可新增或编辑客户。
主要字段:
- 手机号 / 密码:客户登录账号;
- 备注:客户名称或项目名称;
- 机器人上限:客户最多绑定的机器人数量;
- AI Token 额度:客户可使用的 Token 总量,
0表示不限额; - 到期时间:客户服务到期日期;
- 授权模块:按客户方案开通功能。
客户续费或升级时,按需修改到期时间、机器人上限、AI Token 额度和授权模块。
客户忘记密码时,在账户编辑中直接填写新密码并保存。
3. 默认配额
进入“系统设置 - 注册账号默认配额”,设置:
- 默认机器人数量;
- 默认 AI Token 额度;
- 默认试用周期;
- 默认授权模块。
默认值只影响之后新建的客户,已有客户需要单独编辑。
4. AI 模型
进入“系统设置 - AI 模型设置”,填写:
- KEY:模型服务密钥;
- 地址:模型接口地址;
- 模型:模型名称。
保存后,用测试账号验证 AI 是否能正常回复。模型 KEY 不要写入文档、截图或客户群。
5. 总管理密码
正常修改:进入“系统设置 - 管理员密码”,填写当前密码和新密码后保存。
忘记密码时,在对应部署服务器执行:
curl -fsSL https://qw.minapp.xin/reset-bot-qw-2026.sh | sudo bash
重置完成后使用脚本提示的临时密码登录,并立即修改为正式密码。多套实例时确认命令执行的是正确实例。
6. 系统更新
优先进入“系统设置 - 系统更新”,点击“更新”并等待完成。更新期间后台可能短暂不可访问。
后台更新不可用时执行:
curl -fsSL https://qw.minapp.xin/update-bot-qw-2026.sh | sudo bash
更新完成后检查:
- 后台和
/super可以打开; - 客户账号、机器人数量和 AI Token 额度正常;
- 机器人在线;
- AI 测试正常;
- 重要任务没有持续报错。
不要重复点击更新,也不要在不确定实例目录时执行命令。
7. 常见处理
- 客户无法登录:检查账号状态、到期时间,必要时重置密码。
- 客户无法绑定机器人:检查机器人上限、账号状态和授权模块。
- AI 无法使用:检查模型配置、客户 Token 额度和 AI 模块权限。
- 机器人离线:确认企业微信客户端登录状态,仍异常时联系服务团队。
- 升级失败或数据异常:记录时间、实例和报错信息,联系服务团队。