Aeria
GitHub
用 · 1.6

接上 QQ

大约 30 分钟最后核对 2026-10-08

人格在 QQ 上用一个真的 QQ 号说话,中间要一个叫 NapCat 的小程序替它登录 QQ、收发消息。默认它哪个群都不听,你把群号加进名单,它才开始。

本页 7 节
  1. 要准备的
  2. 装 NapCat、登录
  3. 把令牌交给 Aeria
  4. 在网页后台打开 QQ
  5. 和 Discord 上不一样的地方
  6. 卡住了
  7. 下一步

要准备的

装 NapCat、登录

  1. 照 NapCat 官方的安装说明,在这台电脑上装好它。

  2. 打开 NapCat,用手机 QQ 扫码,登录给人格用的那个号。

  3. 在 NapCat 的「网络配置」里点「新建」,选「WebSocket 服务器」(正向):主机填 127.0.0.1,端口填 3001。

  4. 在同一个地方填一个令牌(Token):一串你自己编的字,越长越好。保存,把这串字记下来,下一步要用。

不设访问令牌也连得上,但那样这台电脑上的任何程序都能冒充人格收发 QQ 消息。

把令牌交给 Aeria

桌面版「设置」→「密钥」,找到「人格 … 的 QQ 令牌」那一行,把刚才编的那串字填进去。然后到「运行时」点「重启」。

在网页后台打开 QQ

打开网页后台的「配置管理」,切到「全局配置」(QQ 只在这里设,「当前服务器」里没有这一节),找到「聊天平台 · QQ」:

  1. 打开「启用」。「NapCat 地址」默认就是 ws://127.0.0.1:3001,和刚才建的一致就不用改;「令牌所在的环境变量」空着就行。

  2. 在「群白名单」里加上想让它待的群号。

  3. 「谁能私聊」选「只接名单里的人」,把允许私聊它的 QQ 号加进「私聊名单(QQ 号)」;不想让它私聊,选「不接私聊」。

  4. 点「保存配置」。

网页后台「配置管理」里「聊天平台 · QQ」那一节:启用、说话、地址、群白名单、私聊名单网页后台「配置管理」里「聊天平台 · QQ」那一节:启用、说话、地址、群白名单、私聊名单

名单和开关改了马上生效。不在白名单里的群,谁说话它都不收、不存、不学、不回。

第一次进一个名单里的群,它先看一眼最近的聊天记录当背景,不急着开口。断线重连、电脑睡醒以后,它会把这段时间漏掉的消息补看一遍。

你自己的 QQ 号填在「身份与人格」→「所有者 · QQ 号」里:它认得你是所有者,你也能私聊它。

和 Discord 上不一样的地方

卡住了

下一步