选择一个会话开始聊天
账号管理
1 选择登录方式
2 完成登录
3 自动接入
先连接 SnowLuma
连接后即可引导登录并自动配置适配器。
完成 SnowLuma 初始化
以下一次性设置完成后,无需再打开 SnowLuma 的管理页面。
首次使用需要本人阅读并同意 SnowLuma 的用户协议与隐私政策:
SnowLuma 要求修改初始密码。已生成一个随机强密码(设置后自动保存在 config.json,无需记忆):
选择登录方式
QQ 登录在 QQ 客户端窗口完成。选择一种方式后按指引操作,本页会自动检测新登录,并自动创建适配器、回填地址、完成接入。
扫码登录 推荐
新设备 / 首次登录最顺畅:在 QQ 登录窗口选择二维码,用手机 QQ 扫码确认
密码登录
在 QQ 登录窗口输入账号密码;新设备通常还需完成滑块或短信验证
快捷登录
这台电脑登录过的账号:登录窗口直接点头像一键登录
未检测到 QQ 客户端进程:请先在本机启动 QQ,然后点「重新检测」。
正在获取二维码…
正在等待登录,检测到新账号后会自动接入…
以下账号此前已登录,可直接接入:
接入成功
连接后自动列出已在 QQ 客户端登录的账号;接入时自动为该账号创建 OneBot WebSocket 适配器并回填地址,无需手动配置。QQ 登录本身请在 QQ 客户端窗口完成(密码 / 扫码 / 快捷登录)。
已连接
QQ 账号(已在客户端登录)
QQ 客户端进程
未登录的进程:请在对应 QQ 客户端窗口完成登录,然后点「刷新」;新登录的账号会出现在上方列表。
添加账号(OneBot v11 WebSocket 端点)
SnowLuma 接入引导(如何拿到 WS 地址)
- 运行 SnowLuma 的 launcher 脚本,打开它的 WebUI(默认
http://localhost:5099,初始密码在启动日志中)。 - 在 QQ 客户端登录目标账号:密码 / 扫码 / 快捷登录均可。新设备首次登录通常要求扫码或短信验证;登录成功后凭据保留在本机,之后可快捷登录,无需每次扫码。
- 在 SnowLuma WebUI 中按引导「接入 QQ 进程」。
- 为该账号添加一个「WebSocket 服务端」适配器,设置监听端口(如 3001)和 access token,复制完整 WS 地址(含路径)。
- 在上方表单填入地址与 token 保存,账号列表中状态点变绿即接入成功,消息开始自动汇入。