搭建 QQ 机器人框架
让一个 QQ 小号变成「机器人」,并跟泽木汰换软件对接。
泽木汰换不直接登录 QQ。它通过 WebSocket 与 QQ 协议框架通信,由框架代劳收发消息。这是 OneBot v11 标准,几乎所有第三方 QQ 机器人都用这套架构。
你只需要选一个框架
NapCat 是目前最稳定、社区最活跃的 QQ NT 协议框架。
- 访问 NapCat 官方 GitHub Releases 页面下载最新版(搜索
NapCatQQ) - 下载 Windows 版压缩包,解压到任意目录
- 双击
NapCatWinBootMain.exe,会自动拉起 QQ 主程序 - 用机器人小号登录(首次需扫码)
- 登录后浏览器会自动打开 WebUI 配置页(默认
http://localhost:6099) - 在 WebUI 里点 网络配置 → 新建 → 选「WebSocket 服务器」
- 名称:随便填,比如
泽木汰换 - 端口:
3001(或任意未被占用端口) - 启用并保存
- 名称:随便填,比如
保存后你就有了一个 WebSocket 地址:
ws://127.0.0.1:3001把这个地址填到泽木汰换的「设置/材料」页里就完成对接了。
Lagrange 是另一个流行的轻量级实现,跨平台、无需 QQ 客户端。
-
从 GitHub 下载
Lagrange.OneBot最新版 -
解压后第一次运行会生成
appsettings.json -
编辑
appsettings.json,找到Implementations字段,配置如下:"Implementations": [ { "Type": "ForwardWebSocket", "Host": "127.0.0.1", "Port": 3001, "AccessToken": "" } ] -
再次运行,按提示扫码登录机器人小号
WebSocket 地址同样是 ws://127.0.0.1:3001。
LLOneBot 是基于 LiteLoaderQQNT 的插件方案,需要先有 LiteLoaderQQNT 环境。门槛略高,不推荐新手使用,这里不展开。
验证机器人是否正常工作
让机器人小号收一条好友消息
用你的炉主大号给机器人小号发一句话。如果框架日志能打出收到消息,说明协议层 OK。
启动泽木汰换并填写地址
在软件「设置/材料」页,WebSocket 地址栏填 ws://127.0.0.1:3001,软件右上角的状态指示器会从「未连接」变成「已连接 (运行中)」。
常见对接问题
状态一直是「未连接」?
- 检查端口是否真的在监听(用上面的
netstat命令) - 检查框架是否正确启用了 ForwardWebSocket 模式
- 端口被占用可以换其他不冲突的端口
- 杀毒软件可能拦截连接,把 NapCat 和泽木汰换都加白
机器人能收到消息但不会回复?
- 框架的发送权限被限制了。进 NapCat WebUI 检查「事件订阅」配置,确保订阅的事件类型不为空
- 机器人小号可能被风控,发不出消息。等待 24~48 小时或换号
安全建议
- 机器人小号仅用于本场直播管理,不要用日常号
- 不要在群里乱用其他 QQ Bot 命令,避免触发腾讯反作弊
- 定期换 IP(特别是同一 IP 跑多个机器人时)
- 不要把 WebSocket 端口暴露到公网,只允许本机访问