🚀 快速开始

使用 NapCat 代挂服务只需要简单的 4 步:

获取邀请码

前往qq群977422639艾特群主要一个邀请码,每个邀请码只能使用一次

注册账号

使用邀请码注册你的专属账号

添加 QQ 实例

填写你的 QQ 号,点击添加实例

到下方控制台点击启动,然后扫码

然后使用手机 QQ 扫描二维码登录扫码按钮在右侧,移动端可能超出了屏幕,可以滑动找到

如果qq小号上显示已登录linux,那么你的 QQ 机器人就可以正常运行了!最主要的部分就是这些了,下面的可以不用看,想看也可以看

📝 注册账号

获取邀请码

邀请码是注册的必要条件,你需要:

注册步骤

打开注册页面

点击登录页面下方的「立即注册」链接

填写信息

用户名(至少3位)、密码(至少6位)、邀请码

完成注册

点击注册按钮,成功后会跳转到登录页

⚠️
每个邀请码只能使用一次,请妥善保管你的账号密码!

➕ 添加 QQ 实例

登录后,在控制面板中添加你的 QQ 账号:

字段 说明 示例
QQ 号码 要挂机的 QQ 号(必填) 123456789
WebSocket 地址 机器人框架的连接地址(选填) ws://127.0.0.1:8080/onebot/v11/ws
Token 连接认证密钥(选填) your_secret_token
💡
如果你不确定 WebSocket 地址,可以先留空,稍后在「修改配置」中设置

📱 扫码登录 QQ

启动实例

在实例列表中点击「启动」按钮

获取二维码

点击「扫码」按钮查看登录二维码

手机扫码

打开手机 QQ,扫描屏幕上的二维码

确认登录

在手机上确认登录,等待状态变为「运行中」

⚠️
二维码过期怎么办?
如果二维码过期,点击「刷新」按钮获取新的二维码
🚫
注意事项:
• 不要在多个设备同时登录同一个 QQ
• 新设备登录可能需要手机验证
• 频繁登录可能触发风控

⚙️ 配置文件说明

配置文件决定了 NapCat 如何连接到你的机器人框架:

{ "network": { "websocketClients": [ { "enable": true, // 是否启用此连接 "name": "mybot", // 连接名称(自定义) "url": "ws://127.0.0.1:8080/ws", // WebSocket 服务器地址 "token": "your_token", // 认证 Token "reportSelfMessage": true, // 是否上报自己发送的消息 "messagePostFormat": "array", // 消息格式:array 或 string "heartInterval": 30000, // 心跳间隔(毫秒) "reconnectInterval": 30000 // 重连间隔(毫秒) } ] } }

常用配置参数

参数 类型 说明
enable 布尔值 true = 启用,false = 禁用
url 字符串 WebSocket 连接地址
token 字符串 认证密钥,留空表示不验证
heartInterval 数字 心跳包发送间隔,单位毫秒
💡
管理员可以在「管理后台」→「实例管理」→「修改配置」中直接编辑配置文件

🔧 管理实例

可用操作

按钮 功能
🟢 启动 启动 NapCat 实例,开始运行机器人
🔴 停止 停止实例,机器人下线
📱 扫码 显示 QQ 登录二维码
📝 修改配置 编辑 OneBot 配置文件(管理员)
📜 日志 查看实例运行日志
🗑️ 删除 删除实例(会先停止运行)

状态说明

❓ 常见问题

启动失败怎么办?

1. 检查 QQ 号是否正确

2. 查看日志中的错误信息

3. 确认配置文件格式正确(JSON 格式)

4. 联系管理员检查服务器状态

二维码扫不出来?

1. 点击刷新按钮获取新二维码

2. 确保手机 QQ 是最新版本

3. 尝试调整屏幕亮度

4. 日志中会显示二维码链接,可以复制到浏览器生成

机器人掉线了怎么办?

1. 检查实例状态是否显示「运行中」

2. 如果已停止,重新启动并扫码登录

3. 查看日志检查掉线原因

4. 可能是 QQ 风控,需要在手机上验证

如何连接到我的机器人框架?

1. 在「修改配置」中设置正确的 WebSocket 地址

2. 确保你的机器人框架已启动并监听相应端口

3. 如果有 Token 验证,需要在配置中填写相同的 Token

4. 保存配置后重启实例生效

忘记密码怎么办?

请联系管理员重置密码,或使用新的邀请码注册新账号。

还有其他问题?

如果你遇到了其他问题,欢迎联系管理员获取帮助

立即登录