3ch01c/hubot

Hubot

这是https://github.com/hubotio/hubot的https://www.docker.com/版本。Hubot是开源聊天机器人框架，帮助团队快速构建自动化协作工具。

快速开始

启动交互式shell中的聊天机器人：

sh
$ docker run -it --rm 3ch01c/hubot

Hubot> @hubot ping
Hubot> PONG

连接团队聊天平台需配置适配器和环境变量。创建hubot.env文件：

sh
cat <<'EOF' > hubot.env
HUBOT_HELP_REPLY_IN_PRIVATE=true
HUBOT_NAME=hubot
HUBOT_SLACK_TOKEN=xoxb-你的令牌-这里
REDIS_URL=redis://redis:6379/hubot
EOF
docker run --env-file=hubot.env docker.xuanyuan.run/hubot

核心功能

• 支持Slack、Campfire等多平台聊天适配器
• 可通过自定义脚本扩展功能
• Redis持久化存储跨重启数据
• 环境变量灵活配置运行参数

使用场景

• 团队聊天自动化（消息提醒、任务分配）
• 工具集成（天气查询、部署通知）
• 自定义工作流（审批流程、数据查询）

配置说明

构建自定义机器人

更换聊天适配器（如Slack）需重新构建：

sh
docker build --build-arg HUBOT_ADAPTER="slack" -t hubot .

注：适配器名称省略hubot-前缀（如Slack对应hubot-slack）。

扩展功能

添加NPM脚本到external-scripts.json：

sh
sed -i '' 's/]/, "hubot-vtr-scripts"]/' external-scripts.json
docker build --build-arg HUBOT_ADAPTER="slack" -t hubot .

开发自定义脚本

挂载本地脚本目录：

sh
docker run -v ./scripts:/hubot/scripts docker.xuanyuan.run/hubot

依赖包通过构建参数添加：

sh
docker build --build-arg HUBOT_ADAPTER="slack" --build-arg HUBOT_PACKAGES="lodash" -t hubot .

持久化

Docker Compose内置Redis提供持久化，多机器人共享时修改REDIS_URL路径（如redis://redis:6379/机器人名称）。

故障排除

进入容器调试：

sh
docker run -it --rm --entrypoint /bin/bash docker.xuanyuan.run/hubot
apt update && apt install -y curl && curl example.com

许可证

MIT协议，详见LICENSE。