泽木汰换

搭建 QQ 机器人框架

让一个 QQ 小号变成「机器人」,并跟泽木汰换软件对接。

泽木汰换不直接登录 QQ。它通过 WebSocket 与 QQ 协议框架通信,由框架代劳收发消息。这是 OneBot v11 标准,几乎所有第三方 QQ 机器人都用这套架构。

你只需要选一个框架

NapCat 是目前最稳定、社区最活跃的 QQ NT 协议框架。

  1. 访问 NapCat 官方 GitHub Releases 页面下载最新版(搜索 NapCatQQ
  2. 下载 Windows 版压缩包,解压到任意目录
  3. 双击 NapCatWinBootMain.exe,会自动拉起 QQ 主程序
  4. 用机器人小号登录(首次需扫码)
  5. 登录后浏览器会自动打开 WebUI 配置页(默认 http://localhost:6099
  6. 在 WebUI 里点 网络配置 → 新建 → 选「WebSocket 服务器」
    • 名称:随便填,比如 泽木汰换
    • 端口:3001(或任意未被占用端口)
    • 启用并保存

保存后你就有了一个 WebSocket 地址:

ws://127.0.0.1:3001

把这个地址填到泽木汰换的「设置/材料」页里就完成对接了。

Lagrange 是另一个流行的轻量级实现,跨平台、无需 QQ 客户端。

  1. 从 GitHub 下载 Lagrange.OneBot 最新版

  2. 解压后第一次运行会生成 appsettings.json

  3. 编辑 appsettings.json,找到 Implementations 字段,配置如下:

    "Implementations": [
      {
        "Type": "ForwardWebSocket",
        "Host": "127.0.0.1",
        "Port": 3001,
        "AccessToken": ""
      }
    ]
  4. 再次运行,按提示扫码登录机器人小号

WebSocket 地址同样是 ws://127.0.0.1:3001

LLOneBot 是基于 LiteLoaderQQNT 的插件方案,需要先有 LiteLoaderQQNT 环境。门槛略高,不推荐新手使用,这里不展开。

验证机器人是否正常工作

检查 WebSocket 端口

Win + R 打开命令行输入 cmd,执行:

netstat -ano | findstr :3001

如果看到 LISTENING 状态的输出,说明端口已开。

让机器人小号收一条好友消息

用你的炉主大号给机器人小号发一句话。如果框架日志能打出收到消息,说明协议层 OK。

启动泽木汰换并填写地址

在软件「设置/材料」页,WebSocket 地址栏填 ws://127.0.0.1:3001,软件右上角的状态指示器会从「未连接」变成「已连接 (运行中)」。

常见对接问题

状态一直是「未连接」?

  • 检查端口是否真的在监听(用上面的 netstat 命令)
  • 检查框架是否正确启用了 ForwardWebSocket 模式
  • 端口被占用可以换其他不冲突的端口
  • 杀毒软件可能拦截连接,把 NapCat 和泽木汰换都加白

机器人能收到消息但不会回复?

  • 框架的发送权限被限制了。进 NapCat WebUI 检查「事件订阅」配置,确保订阅的事件类型不为空
  • 机器人小号可能被风控,发不出消息。等待 24~48 小时或换号

安全建议

  • 机器人小号用于本场直播管理,不要用日常号
  • 不要在群里乱用其他 QQ Bot 命令,避免触发腾讯反作弊
  • 定期换 IP(特别是同一 IP 跑多个机器人时)
  • 不要把 WebSocket 端口暴露到公网,只允许本机访问

下一步

机器人对接好后,回到 快速上手第 3 步 继续,或直接深入 配置项详解