QQ 聊天机器人小薇 2.1.0 发布!

本贴最后更新于 2774 天前,其中的信息可能已经渤澥桑田

本次发布加入了支持茉莉机器人,并且更容易搭建开发环境,在线显示登录二维码~

简介

XiaoV(小薇)是一个用 Java 写的 QQ 聊天机器人 Web 服务,可以用于社群互动:

  • 监听多个 QQ 群消息,发现有“感兴趣”的内容时通过图灵机器人或百度机器人进行智能回复
  • 监听到的 QQ 群消息可以配置推送到论坛某个接口上,以实现论坛弹幕或者动态聚合效果,请看实例
  • 在论坛代码中调用小薇进行 QQ 消息推送,比如论坛有新帖时自动推送到 QQ 群
  • 加小薇为好友后可通过暗号(key)让她群推消息

总之,如果你需要一个连通 QQ 群和论坛的机器人,小薇是个不错的选择!

作者

小薇的爸爸叫 Daniel,妈妈叫 Vanessa,其他好心人可以在这里看到。

体验

体验之前一定要先仔细看完这个帖子:如何正确地使用小薇 QQ 机器人

  • 加 QQ 群 13139268,然后发消息“小薇,你好!”
  • 加小薇(Q3082959578)和小薇的守护(Q316281008)为好友,然后将他们都邀请进你所在的群就可以开始调戏了 请自建私服
  • 在论坛的社群动态页面可看到由 QQ 群同步过来的消息

FAQ

如何正确地使用小薇 QQ 机器人?

论坛帖子传送门

为什么要单独做成一个 Web 服务,而不是一个依赖 jar?

做成依赖库的话会随应用部署,从开发的角度是比较方便,但有个致命的问题是应用一般是部署在云端,而登录扫码是在本地,这样会造成 QQ 的异地登录,导致很多问题。

所以需要将小薇部署在本地,保证用手机和小薇启动后 QQ 不出现异地登录。但是这也需要解决一个问题,即需要为小薇提供“内网穿透”的能力,比如使用 ngrok,具体可参考这里

为什么会出现“发送失败,Api 返回码[1202]”?

这个问题是因为 QQ 服务器判断消息有问题时的返回,具体可关注这个 issue

目前已经使用“小薇的守护”进行了改进,大幅度提升了消息发送的成功率。

出现“Api 返回码[103]”怎么破?

先关闭小薇,然后将小薇、小薇的守护两个账号依次分别登录 w.qq.com 后在设置中退出登录,最后再次启动小薇,这时扫码后应该就不会 103 了。

报错 Group list error [groupId=xxxx], please report this bug to developer... 怎么破?

同 103 错误处理步骤。

为什么输出日志是乱码?

是由于控制台编码造成,可以在将 src/main/resources/log4j.properties 中加入 log4j.appender.stdout.Encoding=UTF-8 来解决。

发现问题该怎么反馈?

启动

  1. 安装好 Java 1.7+、Maven 2+
  2. Clone 本项目,并在项目根目录上执行 mvn jetty:run

这样小薇就启动了,然后根据输出提示进行扫码登录:

  • 第一次扫码是小薇登录
  • 第二次扫码是小薇的守护登录(如果启用了守护才会需要扫第二次码)

小薇的守护只需要和小薇在同一个群就行(守护不要用自己的,需要用一个不发消息的 QQ,不然消息监听会有问题)。

另外,如果你一定要在服务器上启动小薇(但真心不建议,请参考 FAQ 第二条):

  1. 打 war 包部署自己的容器,需要修改 latke.props 中的 serverHost 为你服务器的公网 IP、serverPort 为你容器监听的端口,如果你用了反向代理,那么 serverHost 可能就是你绑定的域名、serverPort 是 80。简而言之,这两个值是你最终访问接口时候的值
  2. 登录的扫码可能有点麻烦,这时可以通过 /login 地址来访问二维码,哥考虑得周到吧 😏 (其实得感谢 @abinnz 和 @red3 在这个改进上面所提出的建议)

配置

配置文件主要是 src/main/resources/xiaov.properties:

  • turing.api & turing.key 定义了图灵机器人的 API 地址和口令
  • baidu.cookie 定义了百度机器人访问需要的 Cookie(登录百度,然后抓包)
  • qq.bot.type 定义了机器人类型,1 是使用图灵机器人,2 则使用百度机器人
  • qq.bot.name 定义了机器人的名字,这个主要是用于识别群消息是否“感兴趣”,比如对于群消息:“小薇,你吃过饭了吗?”包含了机器人的名字,机器人就对其进行处理
  • qq.bot.key 定义了管理 QQ 或论坛发过来的消息群推的口令,需要消息开头是这个口令,验证过后才会群推后面的消息内容
  • qq.bot.pushGroups 定义了群推的群名,用 , 分隔多个群;也可以配置成 * 推送所有群
  • qq.bot.pushGroupUserCnt 定义了群推时群人数的下限,只有大于等于这个人数的群才推送
  • qq.bot.ack 定义了是否启用消息送达确认机制(小薇的守护),默认不启用
  • bot.follow.keywords 定义了监听群消息时的关键词,碰到这些词就做处理,比如对于群消息:“如何能在 3 天内精通 Java 呢?”包含了关键词 Java,机器人就对其进行处理
  • bot.follow.keywordAnswer 定义了监听群消息时出现了关键词后的回复模版
  • forum.api & forum.key 定义了论坛 API 地址和口令,小薇会将所有监听到的消息通过该 API 转发到论坛

API

论坛推送 QQ 群

  • 功能:小薇提供给论坛调用的 HTTP 接口,用于将论坛的内容推送到 QQ 群
  • URL:/qq
  • Method:POST
  • QueryStr:key={qq.bot.key}&msg={msgcontent}(也可以放到 Body 里面)
  • 例如:/qq?key=123456&msg=Hello

QQ 群推送论坛

  • 功能:由论坛提供给小薇调用的 HTTP 接口,用于将 QQ 群消息推送到论坛(这个接口是论坛实现的,这里是给出小薇的调用方式和参数)
  • URL:{forum.api}
  • Method:POST
  • QueryStr:key={forum.key}&msg={msgcontent}&user={hexuserid}
  • 例如:/xiaov?key=123456&msg=Hello&user=0a

鸣谢

小薇的诞生离不开以下开源项目/产品服务:


其他教程

如果上面的文档看得一头雾水(作者语文高考差点不及格,见谅),请看下面由热心开发者提供的图文并茂、绘声绘色的、认真的教程:


PS:附送一批黑客派论坛注册邀请码:

wgXvmqHEZ119YoiE
FmQBnsAirHKFmdIU
rVXqTa27xnhl2vF8
CMQvkzQGQhKILw0A
aPBE2B3nEnFuA6xD
5kwXwkYDEMPF9jpt
LeAVaxR5L0HhkKYJ
3oNgY58dpDU3s7dT
HX21YNhK0Goz64S8
bHAnNbsJTIy0MlIx

如果邀请码都被使用了,请加 QQ 群 13139268 后找管理要吧 :-p

  • 小薇

    小薇是一个用 Java 写的 QQ 聊天机器人 Web 服务,可以用于社群互动。

    由于 Smart QQ 从 2019 年 1 月 1 日起停止服务,所以该项目也已经停止维护了!

    34 引用 • 467 回帖 • 688 关注
  • QQ

    1999 年 2 月腾讯正式推出“腾讯 QQ”,在线用户由 1999 年的 2 人(马化腾和张志东)到现在已经发展到上亿用户了,在线人数超过一亿,是目前使用最广泛的聊天软件之一。

    45 引用 • 557 回帖 • 224 关注
  • 机器人
    23 引用 • 330 回帖 • 1 关注
  • B3log

    B3log 是一个开源组织,名字来源于“Bulletin Board Blog”缩写,目标是将独立博客与论坛结合,形成一种新的网络社区体验,详细请看 B3log 构思。目前 B3log 已经开源了多款产品:SymSoloVditor思源笔记

    1090 引用 • 3467 回帖 • 298 关注

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • 好快。这个里面就不需要邀请码了吧。

  • 88250

    @Vanessa 嗯,等会更新一下

  • R

    👏 点赞,小薇越来越机智了

  • R

    @88250 为什么在未登录的情况下,有的帖子能看,有的不能看呢

  • 88250

    @R 有的帖子做了跳过,在 sym.props 里面

  • R 1

    @88250
    嗯,刚在本地部署测试,还没仔细看。
    刚模拟百度爬虫,能够访问到内容 👍

  • relyn 1

    赞!我还以为 D 大不维护这个项目了呢,下次加上微信协议哈哈

  • 88250

    @relyn 谢谢你对小薇的代码和文档的很多贡献,非常感谢

  • relyn

    @88250 建议在打包 dependencies.jar 包的时候,在 SmartQQClient.java 中的第 72 行可以考虑注释掉,避免小薇在没有接收到消息的时候一直出现 SocketTimeout 的告警
    1472018542006

  • 88250

    @relyn 有考虑过,但担心会放走其他问题,所以....

  • ouzhouyou

    @88250 怎么进行知识训练呢? 比如查找内网的一些 wiki

  • 88250

    @ouzhouyou 好像图灵机器人可以加入自己的知识库进行训练,具体没试过

  • blague

    smartqq 这个坑别入了。
    太坑了!

    1 回复
  • 88250

    为了好玩可以体验一下的嘛,但如果是想稳定并用于‘商业’用途就确实别入此坑了

请输入回帖内容 ...