部署文档

阅读当前文档内容。

文档

独立部署

面向独立部署实例的总管理员,负责客户账号、配额、模型和版本维护。

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 模块权限。
  • 机器人离线:确认企业微信客户端登录状态,仍异常时联系服务团队。
  • 升级失败或数据异常:记录时间、实例和报错信息,联系服务团队。