云梦框架使用教程(qq官方机器人)

云梦框架使用教程(qq官方机器人)

昨日南墙
2025-05-07 / 0 评论 / 41 阅读 / 正在检测是否收录...

一 前言

随着QQ官方机器人开放平台的推出,越来越多的开发者开始尝试构建自己的QQ机器人。为了更高效地开发和管理QQ机器人功能, 云梦框架 应运而生。它是一个专为QQ官方机器人设计的轻量级开发框架,提供了丰富的API封装、事件处理机制以及模块化结构,帮助开发者快速上手并搭建功能强大的机器人应用。
本文将带你全面了解如何使用云梦框架进行QQ机器人的开发,包括环境搭建、基础功能实现、进阶技巧等内容。

二 准备工作

注册机器人账号

  • 访问QQ开放平台
  • 创建一个机器人应用

    点击图中 创建机器人 按钮

    1

    根据自己的需要创建的机器人信息填写
    填写完成后点击 下一步

    2

    点击提交审核

    3

    这样就算是创建好了一个机器人应用了

    配置机器人

    在上一步中我们已经创建好了一个机器人应用,我们就该配置机器人了
    点击你创建的这个机器人应用,进入到机器人配置界面,如下图所示

    4

    点击 使用范围和人员

    5

    点击 编辑

    6

    根据自己的需求选择白名单
    我的建议是选择 全部 (第一张是公域机器人,第二张是私域机器人)

    77
    7

    选择完白名单之后,就点击 确认
    点击确认后会有身份验证 如下图

    8

    身份验证使用注册机器人的qq扫码即可,后面不再赘述, 也不再提示需要身份验证
    遇到身份验证就直接使用qq扫码即可
    下一步就是沙箱配置
    点击 沙箱配置
    选择配置的沙箱群
    注意:沙箱群不可以超过20人!且创建该机器人的qq号必须得是该群的管理员或者群主

    9

    向下翻 继续配置频道沙箱
    但是如果没有频道使用需求的可以暂时不用配置

    10

公域机器人与私域机器人的区别

公域机器人功能更少,需要一定的使用人数才能申请更多的权限,但是任何人都可以添加到群聊中
私域机器人则功能更多,ark不需要使用人数就能使用,但是私域机器人的局限性更大

获取AppID以及AppSecret

点击 开发管理
被框住的两个就是我们需要的AppID以及AppSecret了

11

如果AppSecret没有数据那么可以点击旁边的 生成

12

注意:AppSecret只会出现一次,请自行保存好

配置IP白名单

点击 我的IP
复制你的ip地址

20

点击 编辑

18

将刚刚复制的ip填入IP白名单中

17

下载云梦框架

下载 云梦框架
下载完成之后就解压到文件夹

13

使用云梦框架

打开 云梦.exe 文件

14

打开之后就点击图片示例

15

将刚刚获取到的AppID和AppSecret填入其中,点击 登录

16

好了这样就算完成了
温馨提醒: 这只是websocket的配置
1