QQ机器人从零到放弃（小白版）
1.初识
1.1机器人
在AI急速发展的时代，我们或多或少接触到了一些机器人，那么机器人是什么？这是GPT4给出的答案：
机器人是一种自动化程序，它可以执行各种任务，例如自动回复消息、处理事件、提供信息等。在计算机科学中，机器人通常指的是软件程序，而不是实际的物理机器人。这些程序可以根据预定的规则或算法执行任务，或者通过机器学习和人工智能来自动学习和适应。总之，机器人是一种能够自主执行任务的程序。
机器人这种自动化程序给我们的生活带来了极大地便利。
1.2认识QQ机器人
QQ机器人是什么？
便携：通过开放接口的形式，QQ 开放平台允许开发者进行机器人定制化开发。
高效：提供一套标准化、易接入的API与websocket事件，可以帮助开发者实现机器人的快速开发和迭代。
趣味：机器人创新 C 端交互方式，通过指令的方式承载服务，让多样化服务变得触手可达。
赋能：频道、群、单聊等QQ场景全面打通，深度融入QQ社交生态，用户基础大，服务范围广。
—来自QQ开发者平台
QQ机器人可以让我们在QQ中体验到AI等智能化服务，下面我们开始学习一下如何自己开发一个QQ机器人。
2.准备
2.1注册
要想创建QQ机器人，我们需要注册QQ开发者平台账号
首先访问QQ开发者平台
点击右上角“立即注册”来到注册页面
选择账号主体为“个人”，如实填写信息并绑定管理员
2.2创建
接下来，登陆账户，来到以下页面
在这里，你可以管理你创建的机器人/小程序
点击创建机器人，填写机器人资料
注意，机器人介绍尽量写详你要支持的功能
当然在后面也可以更改
然后我们就来到了机器人的资料页面
在侧栏-沙箱配置里选择一个沙箱群聊/频道
需要为群主/频道主或管理员，人数不大于20人
机器人类型建议选择私域，如果你有能力，可以选择公域
这里以私域为主
配置完成后我们来到侧栏-开发设置，这里我们先准备下一个项目。
2.3框架
本篇教学基于小白，我们开始介绍框架
框架是什么？
机器人框架是一种用于支持 QQ 机器人的软件平台。这些框架允许开发者创建自定义的插件，实现各种功能。
本教程主要使用 Koishi 框架
Koishi 是一个跨平台、可扩展、高性能的聊天机器人框架。它的名字和图标设计来源于东方 Project 中的角色古明地恋 (Komeiji Koishi)。古明地恋是一个会做出无意识举动的角色，取这个名字既象征着聊天机器人的主题，也蕴含了开发者为之倾注的热爱。
—Koishi文档
首先我们需要在你的服务器/计算机上下载Koishi桌面
访问 Koishi 官网，点击即刻起步，选择你的运行环境，这里我们以windows为例
下载.msi安装包
———以下来自Koishi文档
双击安装包并一路点按「Next」，等待安装过程结束，你便可以在「开始」菜单中找到 Koishi 了
安装流程在部分电脑上这可能会花费 10 分钟以上的时间，请耐心等待
安装完成后，点击 Koishi 图标即可启动。等待几秒钟，Koishi 控制台将会被打开，现在你可以开始使用 Koishi 了
Koishi 的一个核心特性是强大的控制台。控制台是一个对用户友好的图形界面，封装了 Koishi 的绝大多数功能：
安装、卸载和更新插件
启用、停用和配置插件
管理指令、数据库、输出文本
在模拟和真实环境下聊天
状态监控、数据统计
查看日志
安装插件
Koishi 不对非官方插件的安全性做任何保证。请不要随意下载来源不明的插件，因为它们可能导致 Koishi 无法运行，甚至更严重的后果。如果你下载插件后遇到了问题，可以前往用户群或论坛进行反馈。此外，部分插件带有「不安全」标识，安装此类插件将不会受到官方群内的支持。
前往「插件市场」页面，你将在这里看到所有可下载的插件。在搜索框中输入你需要的插件，找到我们想要的插件，点击「添加」按钮，然后在弹出的对话框中点击「安装」。等待片刻，插件就已经安装成功了。
———
3.起步
3.1对接
下面开始对接QQ教学
适配器是什么？
Koishi 使用适配器插件来支持各种聊天平台。其中，常用的适配器插件已经预装在了 Koishi 中，你可以在插件配置中的 adapter 分组中找到它们。如果没有看到你想要的平台，你也可以在插件市场中搜索并安装更多适配器插件。
请先在Koishi内的插件市场搜索 “adapter-qq” 下载QQ机器人适配器
下载完成后进入插件配置
我们回到QQ开发者平台，记录下开发设置里的机器人ID、密钥、令牌
在适配器中填入，开启沙箱模式（sandbox）
针对未审核上线的机器人只能选择沙箱模式，只能在沙箱频道/群中测试机器人，提交审核时/上线后需要关闭沙箱模式
机器人类型选择“private”，订阅事件如下图所示（针对私域机器人）
其他配置保持默认，点击保存配置，接下来配置开发平台
在开发设置里的IP白名单填入服务器IP，保存
接下来回到koishi，启用qq适配器插件，如果出现：
（针对沙箱模式）
adapter connect to server: wss://sandbox.api.sgroup.qq.com/websocket
则代表机器人连接成功
否则请仔细翻看教学并查错，不会的可以联系XMJ QQ：
3078780148
3.2起飞
连接好机器人后，我们可以在插件市场下载你所需要的插件
（不要乱整，会炸的，血的教训QAQ）
我们以echo插件为例，插件市场搜 “echo” 并下载插件
插件下好后启动插件，我们可以在沙箱频道/群中进行操作：
（记得把机器人拉进你的沙箱频道/群）
at机器人 echo 123
示例：
AA：@Bot echo 你好
Bot：@AA 你好
（这个bot @AA是qq特有的）
下面我们看看koishi官方的解释
———
———
4.入土
4.1自己开发
如果你对Koishi等框架不满意，或者框架内的市场没有你想要的插件，你也可以选择自己开发
如果你要开发框架插件，请参考对应框架的开发文档
如果你要从0开始，请参阅 QQ机器人开发API文档
4.2你是大蛇
如果你都不满意，你也可以自己创建一个语言，自己创建一个聊天平台，自己创建一个大型AI机器人，到时候你就可以用AI统治世界！
5.结束
5.1反馈
如果你有建议，或者本文章有什么需要整改的地方，欢迎打扰XMJ QQ：
3078780148
对于机器人的不理解也可以联系
5.2引用
BingAI_基于ChatGPT4
5.3声明
禁止基于本教学做任何违背社会道德、法律等事
本篇教程仅适用于教学为主，任何后果责任由用户本人承担，与本论坛、作者、平台无关！
XMJ个人主页:https://lingxmj.top
赞助XMJ:https://lingxmj.top/pay
您也可以点击打赏按钮进行打赏
好哥哥给点叭QAQ
