
Koishi + Lagrange.OneBot 部署 QQ ChatGPT 机器人
Koishi
官网:Koishi
Koishi 是一个跨平台、高性能的聊天机器人框架,灵感来自东方 Project 中的角色 古明地恋。
Koishi 拥有庞大的插件生态,无论是日常娱乐还是实用功能,你都能在这里找到。
特点:
- 开箱即用: 提供控制台,支持主流聊天平台(如 QQ、Telegram、Discord),用户可快速搭建聊天机器人。
- 生态丰富: 拥有超过 1000 个插件,适合构建大型应用或轻量级辅助机器人。
- 专为开发者打造: 提供 TypeScript 支持、单元测试和模块热重载等功能,简化插件开发过程。
部署 Koishi
Docker
1 | # 创建网络 |
Docker Compose
1 | services: |
1 | docker compose up -d |
登录 Koish 控制台
地址:你的IP:15140
更新依赖
先点击左侧边栏的 依赖管理
,然后右上角先点 小火箭
在点 ✔
更新全部依赖
Lagrange.OneBot 消息平台
Lagrange 介绍
Lagrange 是一个 QQNT 协议逆向工程框架,比 Shamrock 或 Mirai 更加轻便,在目前也较为稳定。通过 OneBot 11 协议接入,需选择使用 aiocqhttp
作为适配器,填写配置时可参考 Shamrock 的方式。
可选平台(需要.NET 8 or 7 支持):
- Mac OS 也可使用
- Linux Ubuntu 22.04,Debian 12 应该都可以
- Windows 10,11,Server2019 及以上
注意: 要使用 NT QQ 发信息,旧版 QQ 无法正常使用
Docker 镜像地址:Package lagrange.onebot docker images
使用版本:2024-07-30 版本
容器启动
Docker
1 | docker run -d \ |
Docker Compose
1 | services: |
1 | docker compose up -d |
二进制文件启动
Releases 地址:Releases · LagrangeDev/Lagrange.Core (github.com)
请根据系统环境下载对应的不要带 musl 的压缩包
1 | wget https://github.com/LagrangeDev/Lagrange.Core/releases/download/nightly/Lagrange.OneBot_linux-x64_net8.0_SelfContained.tar.gz |
配置文件
首次运行时,程序会在同级目录下自动生成默认的 appsettings.json
配置文件。请正确修改该文件以设置 Lagrange。
完成配置文件修改后(建议使用扫码登录),在命令行中按任意键启动 Lagrange。随后,同一文件夹下会生成一张名为 qr-0.png
的登录二维码图片。请在二维码过期前,尽快使用手机 QQ 扫码连接。
需要配置 Lagrange 以让其连接上 Koishi,请编辑 Lagrange 的配置文件 appsettings.json,确保 Implementations 中的连接配置符合下图内容:
- 端口可自定义
- AccessToken 验证密钥
- Host 如果是二进制部署且 Lagrange 和 Koishi 都在同一台服务器上则看填
127.0.0.1
1 | { |
修改后文件:
1 | { |
QQ 登录
修改配置文件后需要重启 Lagrange.OneBot
- 二进制启动直接可能看到二维码或在本目录下
qr-0.png
的登录二维码图片 - 如果使用 docker 则
1 | docker logs lagrange-onebot |
配置 QQ 机器人
echo 插件
进入插件市场搜索 echo
插件,安装
左侧边栏进入沙盒,添加一个用户,发送 帮助
,测试一下功能
adapter-onebot 插件
安装
回到 koishi 的插件商店,搜索安装 adapter-onebot 插件
安装完成会自动进入插件管理页面,右键 adapter 分组,选择添加插件,找到刚刚安装的 adapter-onebot 插件,添加。
配置
- 使用 Docker 部署 则 ws://lagrange-onebot:15141/ws
- 本地部署则填写你的 ip: 端口 /ws
日志信息中出现以下内容及服务连接成功
chatluna 多平台模型
安装后,在插件管理中添加 chatluna 插件
cache 安装一项即可,后按你的需求添加对应的插件
安装 openai-like-adapter 插件
按要求填写你的 API 信息。 我的 API 平台是 https://api.kl.do 支 ChatGPT、Claude、Deespeek 等主流大模型,欢迎使用!
Koishi 控制台设置登录授权
- Thanks for your appreciation. / 感谢您的赞赏