本地运行Hubot
Hubot
Hubot是Github开发并开源的chatbot，但它并不仅仅是一个聊天机器人，Hubot已经广泛应用于Github的日常运维工作，被称为最忙碌的员工。
安装Hubot
Hubot是基于node.js、npm技术体系，使用CoffeeScript语言开发的开源chatbot，github地址：https://github.com/github/hubot
安装 node.js & npm
直接去官网下载安装：https://nodejs.org/
安装Hubot生成器
要运行自己的Hubot，需要通过生成器生成，首先安装generator-hubot
npm install -g yo generator-hubot
生成自己的hubot
mkdir myhubot
cd myhubot
yo hubot
启动myhubot
windows下直接执行hubot命令即可
bin\hubot.cmd
控制台应该可以看到如下信息：
loadDep:basic-auth ▌
loadDep:base64-url ▌
loadDep:debug ▌
loadAllDepsIntoIdealTree ?
build:. → linkMans ▄
runTopLevelLifecycles ?
myhubot> [Mon May 16 2016 14:55:09 GMT+0800 (中国标准时间)] WARNING Loading scripts from hubot-scripts.json is deprecated and will be remove
d in 3.0 (https://github.com/github/hubot-scripts/issues/1113) in favor of packages for each script.
Your hubot-scripts.json is empty, so you just need to remove it.
[Mon May 16 2016 14:55:09 GMT+0800 (中国标准时间)] ERROR hubot-heroku-alive included, but missing HUBOT_HEROKU_KEEPALIVE_URL. `heroku config
:set HUBOT_HEROKU_KEEPALIVE_URL=$(heroku apps:info -s | grep web-url | cut -d= -f2)`
[Mon May 16 2016 14:55:10 GMT+0800 (中国标准时间)] INFO hubot-redis-brain: Using default redis on localhost:6379
myhubot>
出现的错误信息是因为默认情况下，hubot使用redis做持久化存储，并支持heroku部署。
为了方便起见，我们可以去掉redis和heroku配置，在./external-scripts.json文件中找到"hubot-heroku-keepalive"和"hubot-redis-brain"并删除即可。
也可以忽略这些错误信息，继续使用hubot。
如何使用myhubot
可以通过help查看hubot支持的指令
myhubot help
myhubot> Shell: myhubot adapter - Reply with the adapter
myhubot animate me <query> - The same thing as `image me`, except adds a few parameters to try to return an animated GIF instead.
myhubot echo <text> - Reply back with <text>
...
如随机获取一张哈巴狗的图片：
myhubot> myhubot pug me
myhubot> http://26.media.tumblr.com/tumblr_lteebc0WeC1qb08qmo1_500.jpg
至此，本地的myhubot已经可以运行起来，下一步就是扩展myhubot，编写自定义scripts来支持自定义指令。
开发自定义机器人脚本
首先，在决定开发自定义脚本时，可以使用npm search命令看看是不是有类似的脚本可以使用。
$ npm search hubot-scripts github
NAME DESCRIPTION
hubot-deployer Giving Hubot the ability to deploy GitHub repos to PaaS providers hubot hubot-scripts hubot-gith
hubot-gh-release-pr A hubot script to create GitHub's PR for release
hubot-github Giving Hubot the ability to be a vital member of your github organization
…
应用NPM 包：
- npm install --save <package-name>
- 将package-name添加到external-scripts.json
第一个script
myhubot 项目结构
- bin/ myhubot运行脚本
- node_modules/ 引用的包文件
- scripts/ 存放自定义脚本
- external-scripts.json 引用的外部脚本
- package.json 项目全局配置信息
我们编写的自定义脚本要放在scripts中，可以是.coffee或.js文件，你可以用CoffeeScript或纯JS编写他们。
默认情况下，需要导出一个function：
module.exports = (robot) ->
# your code here
首先我们在scripts中创建第一个脚本,hello.coffee
module.exports = (robot) ->
robot.respond /greet/i, (res) ->
res.send 'hello world.'
重启myhubot，输入myhubot greet
myhubot> myhubot greet
myhubot> hello world.
Hubot script语法
Hearing & responding
hearing可以监听房间或群组中任何消息。
respond只监听直接发送给机器人的消息,也就是需要指定机器人名称或别名，加入机器人名称是rob,别名是/,则如下格式会触发脚本：
- rob open the pod bay doors
- ROB: open the pod bay doors
- @ROB open the pod bay doors
- /open the pod bay doors
Send & reply
res参数是Response实例，如果要从机器人返回消息，可以使用send或reply。
send会将消息发送到整个聊天房间或群组。
reply会将消息回复给具体的人。
更多信息请参考官网 https://hubot.github.com/docs/scripting/
复杂一点的例子
Hubot是基于node.js开发的，所以它可以做到node.js所能做的，如：
- 发消息
- 回复消息
- 发起http请求
- 返回http响应
- 在远程服务器上执行shell命令
- ...
例子： 查看服务端日历信息
scripts/calculate.coffee
child_process = require('child_process')
module.exports = (robot) ->
robot.respond /(cal|日历)( me)?/i, (res) ->
child_process.exec 'cal', (err, stdout, stderr) ->
res.send(stdout)
重启myhubot，输入myhubot cal，就可以看到控制台返回服务端日历信息
Su Mo Tu We Th Fr Sa
1 2 3 4 5 6 7
8 9 10 11 12 13 14
15 16 17 18 19 20 21
22 23 24 25 26 27 28
29 30 31
捕获所有未处理信息
为了使机器人响应更加友好，对于未能识别的信息，可以设置一个默认返回信息。
scripts/catchAll.coffee
module.exports = (robot) ->
robot.catchAll (res) ->
res.send "主人，无法识别您的指令：#{res.message.text}"
集成到微信
hubot默认提供两种adapter,shell和campfile。
shell提供命令行方式，用于开发调试或者运维还可以，用于聊天太逊了。
campfile聊天工具在中国都没几个人听过，不用也罢。
依赖于hubot的灵活扩展机制，社区提供了多种聊天工具的集成adapter。可以在官网上找到。
不过在中国，最流行的聊天软件当然是微信，将自己的聊天机器人绑定到微信账户上，没事调戏下，是不是很有趣。
好在，已经有人做出了微信adapter,地址:https://github.com/KasperDeng/Hubot-WeChat
接下来，我们集成Hub-WeChat到我们的工程中来即可。
npm install hubot-weixin --save
运行myhubot，设置名称为bot,别名/，这样只需要输入/cal就可以激活机器人了。
bin\hubot.cmd -n bot -l / -a weixin
这样运行命令当然会出错，hubot-weixin工作的主要机制是hack网页版微信协议，先用手机登录微信帐号，然后模拟网页版微信登录，这样就可以接受微信消息了。
可以按照如下步骤设置：
1.首先为机器人注册一个新的微信号或者使用已有的微信号；
2.在手机端登录微信；
3.在chrome浏览器打开网页微信：web.weixin.qq.com,F12打开控制台监控请求信息；
4.用手机扫描登录；
5.控制台应该会监控到很多请求信息；
6.从这些请求信息中找出如下信息，并填写到./node_modules/hubot-weixin/config.yaml:
cookie:
Uin:
Sid:
Skey:
DeviceID:
这下，重新运行命令就可以了，如果有错误，就按照刚才的步骤检查这些参数设置是否正确，也可以用postman等工具调试看看。
bin\hubot.cmd -n bot -l / -a weixin
正确启动后，将机器人微信号添加为好友，就可以通过微信发消息给机器人了。
接下来
接下来，可以考虑做些更好玩的事情。
- 比如绑定语音服务，将语音转换成文字指令。这样就可以通过语音指挥机器人做事情了。
- 编写部署运维脚本，使机器人可以真正用于日常的开发运维工作。也就是所谓的chatops。
