hubot-qq

QQ adapter for Hubot, and also A dependence robot lives on webQQ

A Hubot adapter for QQ! And also A independence robot lives on the real world.
FYI: QQ is a instant messaging service widely used in china provided by Tencent.

基于WebQQ协议的QQ机器人。命令行工具,由不可思议的CoffeeScript提供支持。

DEMO 调戏用(测试和交流)QQ群:346167134

  • :muscle: 登录和验证码支持
  • :muscle: 支持好友,群,讨论组的接入
  • :muscle: 插件化,目前支持消息的派发
  • :muscle: 可作为hubot adapter使用
  • :muscle: 提供HTTP API支持(比如群通知什么的都能做哦)
  • 辅助管理群成员,比如自动清理刷屏用户啊(请自己实现)
  • 聊天机器人(请自己实现AI)
  • 部署机器人(请了解hubot的概念)
  • 通知机器人(监控报警啊什么的,对于天天做电脑前报警还得通过邮件短信提醒多不直接呢)
  • Add hubot-qq as a dependency in your hubots package.json
  • Run npm install in your hubots directory
  • Run hubot with bin/hubot -a qq

Configurable Variables

HUBOT_QQ_ID         #QQ ID
HUBOT_QQ_PASS       #password
HUBOT_QQ_GROUP      #group name that hubot listens to
HUBOT_QQ_IMGPORT    #the port to serve verify-codes
#for more debug variables plz check src/hubot-qq source file

On LINUX or OSX use export VARIABLE=VALUE to set environment variables.

  • Install CoffeeScript in global by sudo npm install -g coffee-script
  • Run npm install to update dependencies
  • Make your own copy of config.yaml
  • Run ./main.coffee to keep your bot alive!

部署环境中一般没法操作STDIN和机器人交互,所以现在提供了 Http Api 提供验证码输入:

GET http://localhost:port/stdin?token=(token)&value=(value)
我常用的命令 ./main.coffee nologin &>> tmp/dev.log &

https://github.com/xhan/qqbot/blob/master/CHANGELOG.md

  • WebQQ协议 https://github.com/xhan/qqbot/blob/master/protocol.md
  • Java版的另一个 http://webqq-core.googlecode.com/
  • 自动重新登录
  • 离线消息忽略设定
  • 机器人响应前缀
  • 图片发送支持
  • 更多的插件
  • QQ纯数字密码的同学,yaml里用 "123456" 代替