zerrozhao/coolqbot

聊天机器人框架（coolqbot）

镜像概述

本镜像基于Golang开发，是一个多平台聊天机器人框架，支持***和QQ（通过CoolQ）等聊天工具接入。框架采用分布式弹性架构，主进程与各聊天工具对接进程分离，通过gRPC通信，支持插件式扩展，开发简单且运维友好。

核心功能

• 多平台支持：兼容***和QQ（CoolQ）。
• 分布式架构：各服务节点独立配置，跨语言通信（gRPC）。
• 插件扩展：轻松添加插件以扩展机器人功能。
• 指令与文件处理：支持command扩展和文件处理器扩展。
• 多语言支持：框架具备多语言适配能力。
• 调试与运维：自带debug模式，所有节点可通过Docker部署。

使用场景

• 个人聊天助手：实现消息自动回复、信息检索等功能。
• 群聊管理工具：自动处理群内指令、管理群成员等。
• 多平台消息同步：在***和QQ之间同步消息内容。
• 定制化机器人开发：通过插件扩展实现特定业务需求（如笔记记录、图片处理等）。

配置说明

接入***

1. 拉取***节点镜像：

sh
docker pull docker.xuanyuan.run/zerrozhao/telegrambot

2. 创建配置文件（cfg目录下）：

yaml
telegramtoken: 你的Telegram机器人Token
token: 框架通信Token
servaddr: 核心节点地址（如127.0.0.1:123）
username: 用户名

3. 启动***节点：

sh
docker container stop telegrambot
docker container rm telegrambot
docker run -d \
    --name telegrambot \
    --link adachatbot:adachatbot \
    -v $PWD/cfg:/app/telegrambot/cfg \
    -v $PWD/logs:/app/telegrambot/logs \
    docker.xuanyuan.run/zerrozhao/telegrambot

接入CoolQ

1. 准备工作：注册QQ号并绑定手机号，开启账号锁定。
2. 初始化CoolQ：使用coolq目录下的init.sh脚本。
3. 启动CoolQ：通过start.sh脚本启动，配置端口、密码等参数。
4. 配置CoolQ HTTP API：修改data/app/io.github.richardchien.coolqhttpapi/config/[QQ号].ini：

ini
serve_data_files = yes
use_ws = yes
ws_host = 0.0.0.0
ws_port = 6700

5. 重启CoolQ。
6. 拉取coolqbot镜像：

sh
docker pull docker.xuanyuan.run/zerrozhao/coolqbot

7. 创建配置文件（cfg目录下）：

yaml
coolqtoken: 
coolqsecret: 
coolqservurl: ws://127.0.0.1:5700
coolqhttpservaddr: 
token: 框架通信Token
servaddr: 核心节点地址（如127.0.0.1:123）
username: 用户名
debug: true
preloaduserinfo: true

8. 启动coolqbot：

sh
docker container stop coolqbot
docker container rm coolqbot
docker run -d \
    --name coolqbot \
    --link adachatbot:adachatbot \
    --link cqhttp:cqhttp \
    -p 7234:7234 \
    -v $PWD/cfg:/app/coolqbot/cfg \
    -v $PWD/logs:/app/coolqbot/logs \
    docker.xuanyuan.run/zerrozhao/coolqbot

版本更新

• v0.6：支持多行command，调整logger模块。
• v0.5：升级Golang到1.13，增加基础chatbot节点，支持图片和forward消息，添加笔记助理功能。
• v0.3：更新grpc和protobuf版本，调整代码结构，支持channel和group。
• v0.2：支持QQ平台。
• v0.1：完成核心架构，支持***节点，实现插件、command等扩展架构。