QQ Bot 管理面板

请使用QQ扫码一键登录,或输入授权码
仪表盘

仪表盘

加载中… 每 10 秒自动刷新

近 14 天消息趋势

点击折线上的数据点,查看当日与前一日的对比数据

机器人状态分布

机器人额度

系统资源

近 24 小时事件趋势

最近事件(实时)

快速操作

机器人

部署进程状态(PM2 · 实时)

编号名称状态CPU内存重启运行时长

功能模块

加载中...

AI 智能回复

AI 设置教程

三步启用 AI 兜底回复:
第 1 步 选择机器人 → 勾选「启用 AI 兜底回复」,设置「生效场景」(群聊 / 私聊;群聊建议保持「仅 @机器人时回复」省金币)。
第 2 步 选择「模型接口(供应商)」并配置密钥:
· 使用系统共享密钥:超级主人已在「模型供应商管理」录入密钥,普通用户选择后直接可用(按次扣机器人所有者的金币);
· 使用我自己的密钥:填入你自己申请的 API Key(如 DeepSeek / 通义 / OpenAI),密钥仅保存在本服务器,调用费用由你的供应商账户承担,不扣面板金币。
第 3 步 按需调整「AI 人设 / 系统提示词」「记忆轮数」「最大回复 tokens」→ 点击「保存配置」→ 用「在线测试」发一条消息验证(测试不扣金币)。
金币规则:仅当消息未命中任何词库指令、且开启了 AI 兜底时才触发;每次成功调用按「机器人所有者金币余额」扣 1 金币,余额不足自动停用并提示充值。
常见问题:① 群里 @机器人没反应 → 检查是否启用、群聊场景是否勾选、触发方式是否为 @;② 回复很慢或报错 → 检查密钥是否有效、Base URL 是否带 /v1;③ 想让 AI 记住上下文 → 把「记忆轮数」调大(每多一轮更耗 tokens)。
超级主人可在本页底部「模型供应商管理」维护共享接口,在「用户金币与侧边栏权限」中充值/扣减金币并控制菜单可见性。
机器人所有者金币余额
-
AI 兜底回复每次成功调用扣 1 金币

兜底回复配置

当 QQ 消息没有命中任何词库指令时,由 AI 模型兜底回复。

套用预设仅填充下方模板,可继续修改
自定义格式可用 {{tools_json}} 引用此处定义

在线测试

直接调用模型验证配置,不扣金币、不写入对话记忆;需先保存配置。

插件词库市场

浏览并安装其他用户分享的词库,安装后可在「插件管理」「词库管理」中编辑使用

- 我的金币
1 / 1

我的机器人

名称AppID所有者状态创建时间操作

成员同步 NapCat 真实 QQ 号自动同步

NapCat OneBot 连接

QQ 开放平台只返回脱敏 OpenID,不提供真实 QQ 号。三种方式获取真实 QQ 号:
① NapCat 同步(推荐,全量自动):在可扫码登录 QQ 的机器上运行 NapCatQQ,配好 HTTP 服务器后填下面地址,测试连接后点"一键同步"。
② 手动映射:我的机器人 → 群管 → 逐成员填 QQ 号。
③ QQ 一键登录:成员/管理员扫码(可截图远程扫码),回跳后输入 QQ 号即自动绑定真实 QQ 号。下面「一键登录」绑当前登录账号,成员行「扫码绑定」生成该成员专属绑定链接(可发给成员本人扫码)。
开启后才会拉取 NapCat 群列表/同步成员;关闭则不连接 NapCat(概览不再报错)

群匹配与同步结果

NapCat 群列表按群名精确匹配本地群(群名不同则匹配不到,可忽略或手动改本地群名)。
NapCat 群群号成员数匹配状态
加载中...
本地已收录群:- 个;NapCat 侧:- 个

所有群成员(QQ 号)

清空后自动从「用户管理 / OpenID 列表」重新获取
选群信息(头像/群名/群号/OpenID)头像昵称QQ 号来源OpenID授权码权限操作
加载中...

群 OpenID 信息

删除群信息及其成员记录(再次发消息会重新收录)
选群头像OpenID群号群名人数今日活跃今日消息机器人回复本周消息操作
加载中...

频道管理 NapCat 小号 / 开放平台频道

用于在网页端查看频道、子频道、读取帖子并发送消息。频道消息需机器人已在频道内且事件链路正常。
频道ID操作
点击「读取频道」加载

代码编辑 在线编辑插件与文本文件(js/php/md/dm/json/txt 等),保存即写入磁盘

文件列表

点击文件加载到右侧编辑。js 保存后需重启服务器生效。
加载中...
选择文件后可编辑。插件 js 保存后需重启服务器生效。

插件管理

插件以卡片展示,勾选后可批量启用/禁用

词库管理

管理服务器 plugins/词库/ 目录下的本地词库文件;词条编辑请在词库编辑器中完成。

勾选词库后可批量设置主人/群授权(对同名词库插件生效)

加载中…

文件管理

名称大小修改时间操作

部署终端

服务器命令终端 · 会话目录: /var/www/php
拉取 GitHub 项目
root@armbian:/var/www/php#

仅超级主人可执行;命令在服务器以 sh -c 运行,当前目录为上方会话目录(cd 可在会话内切换)。常用于:unzip -o 解压更新包、pm2 restart qqbot 重启机器人。「拉取 GitHub 项目」把会话目录源码与 Git 远端强制同步(忽略文件 data/node_modules/dist 不受影响;会覆盖本地未提交改动),QQgfbot 源码在 https://github.com/lzyzyzq/QQgfbot

系统设置

个人设置

管理面板配置

内部服务监听端口(nginx 反代目标)。注意:不要填网页访问端口 6655,否则会与 nginx 冲突导致 502

文字链接模式菜单的跳转地址(不要带端口)。不填则文字链接不生效;需先在 QQ 开放平台「安全设置-网页可跳转域名」添加该域名

群内发送「文字外显 开/关」亦可切换(需群主/群管理)

文字链接模式菜单的「@机器人昵称 指令」按钮使用;需与 QQ 开放平台机器人昵称一致才能被 @ 识别

天气来源 wttr.in;城市填中文名(如 上海 / 广州 / 成都)

占位符 {city} = URL 编码后的城市名、{cityRaw} = 原城市名;接口需返回「天气 温度 湿度 风速」空格分隔格式;留空恢复默认 wttr.in

{city} / {cityRaw} 同上;留空默认 wttr.in 天气图。也支持在引擎「插件卡片·变量管理」配置变量 weather_api(仅文本接口,优先级低于此处)

显示在报时图片最下方一行

插件回复用 <php? 输出内容 php> 包裹时,自动在其后追加此行 + 底部广告;无标记的消息不追加

申请地址 qq.wch666.com(心月互联),点「QQ 一键登录」会跳转 qq.php?token=该Token&display=pc/mobile 扫码;回调地址填面板根地址(如 https://armbian.tailaa2e36.ts.net:6655/);扫码成功自动跳回完成登录

留空=默认依次拉取 GitHub raw(lzyzyzq/QQgfbot)→ GitHub 加速镜像 → 8091 备用 的 update-config.json(AI 发版统一维护版本/下载地址/镜像列表/更新内容)。手动填地址(可用逗号分隔多个)可优先指定某源;全部拉取失败时自动回退本机面板「更新系统配置」

或上传本地 zip:

功能开关

功能说明状态操作

定时任务

ID类型内容时间/间隔目标群机器人状态操作

GitHub 云端广播 (broadcast/broadcast.json 多源拉取;支持全部群/单一群/目标群,文本/图片,API 抓内容,定时到点自动广播)

来源:- 试播目标: 发送方式:
ID名称状态发送目标定时内容操作

用户管理

按群同步用户:群头像 / 群号 / 群OpenID / 群名 + 成员 QQ / 昵称 / OpenID / 授权码 / 权限,支持修改、删除、重新获取

加载中...
选群信息(头像/群名/群号/OpenID)头像昵称QQ 号来源OpenID授权码权限操作
加载中...

OpenID 列表

一个 QQ 号名下的所有 OpenID(不同机器人写入的 OpenID 各不相同),标注来源机器人、所在群;支持编辑/删除,实时写后端,与「用户管理」串联。「刷新」自动同步群成员最新昵称,本页每 30 秒自动刷新

仅解除 OpenID 与 QQ 号的绑定,保留成员记录
选头像QQ 号昵称OpenID来源机器人所在群更新时间操作
加载中...

反馈

插件「反馈 内容」命令提交的反馈信息

状态用户QQ内容时间操作

系统日志

运行记录

级别类别机器人内容(完整)用户/群(完整)时间

授权码管理

仅超级主人生成的授权码(超级主人角色)可登录面板;小主人/会员授权码仅用于群内激活权限
授权码角色创建者过期使用状态操作

更新日志

帮助文档