LLOneBot
主页部署文档
主页部署文档
  1. 接口列表
  • LLTwoBot 接口文档
  • 上报事件
  • 接口列表
    • HTTP 调用/接收消息
    • Websocket 发送/接受消息
    • 用户
      • 点赞
      • 好友列表
      • 好友列表(带分组)
      • 删除好友
      • 处理好友申请
      • 设置好友备注
      • 获取好友或群友信息
      • 设置个人头像
      • 好友戳一戳(双击头像)
      • 上传私聊文件
      • 获取我赞过谁列表
      • 获取谁赞过我列表
      • 获取官方机器人QQ号范围
      • 移动好友分组
      • 获取QQ头像
    • 群组
      • 群列表
      • 群详情
      • 群成员列表
      • 获取群成员信息
      • 群员戳一戳(双击头像)
      • 获取群系统消息
      • 处理加群请求
      • 退群
      • 设置群管理员
      • 设置群名片
      • 群禁言
      • 群全体禁言
      • 获取被禁言群员列表
      • 设置群名
      • 批量踢出群成员
      • 群踢人
      • 设置群头衔
      • 群荣誉
      • 获取群精华消息
      • 设置群精华消息
      • 删除群精华消息
      • 获取群根目录文件列表
      • 上传群文件
      • 删除群文件
      • 创建群文件文件夹
      • 删除群文件文件夹
      • 获取群文件资源链接
      • 获取群 @全体成员 剩余次数
      • 发送群公告
      • 获取群公告
      • 群打卡
      • 设置群消息接受方式
      • 设置群备注
      • 获取已过滤的加群通知
      • 获取群子目录文件列表
    • 消息
      • 发送私聊消息
        • 发送私聊文本消息
        • 发送私聊回复消息
        • 发送私聊图片
        • 发送私聊文字+图片
        • 发送私聊系统表情
        • 发送私聊语音消息
        • 发送私聊视频消息
        • 发送私聊超级表情 骰子
        • 发送私聊超级表情 猜拳
        • 发送私聊QQ音乐卡片
        • 发送私聊网易云音乐卡片
        • 发送私聊自定义音乐卡片
        • 发送私聊卡片(json)消息
        • 发送私聊合并转发消息
      • 发送群聊消息
        • 发送群聊文本消息
        • 发送群聊回复消息
        • 发送群聊@消息
        • 发送群聊图片
        • 发送群聊文字+图片
        • 发送群聊系统表情
        • 发送群聊语音消息
        • 发送群聊视频消息
        • 发送群聊超级表情 骰子
        • 发送群聊超级表情 猜拳
        • 发送群聊QQ音乐卡片
        • 发送群聊网易云音乐卡片
        • 发送群聊自定义音乐卡片
        • 发送群聊卡片(json)消息
        • 发送群聊合并转发消息
      • 长连接接收消息
      • 转发单条好友消息
      • 转发单条群消息
      • 获取消息详情
      • 撤回消息
      • 获取消息文件详情
      • 获取消息图片详情
      • 获取消息语音详情
      • 表情回应消息
      • 取消消息表情回应
      • 获取好友历史消息记录
      • 获取群历史消息
      • 获取转发消息详情
      • 标记消息已读
      • 语音消息转文字
      • 发送群 Ai 语音
    • 系统
      • 获取登录号信息
      • 获取版本信息
      • bot状态
      • 清理缓存
      • 获取cookies
      • 设置在线状态
      • 重启
    • 其他
      • 图片 OCR
      • 上传闪传文件
      • 下载闪传文件
      • 获取闪传文件详情
      • 获取图片rkey
      • 获取推荐表情
      • 获取收藏表情
      • 下载文件到bot所在
      • 获取群 Ai 语音可用声色列表
  • 数据模型
    • 上报事件
      • 消息段
        • MessageSegment
        • TextSegment
        • ImageSegment
        • VideoSegment
        • RecordSegment
        • FileSegment
        • FlashFileSegment
        • AtSegment
        • ReplySegment
        • JsonSegment
        • XmlSegment
        • FaceSegment
        • MfaceSegment
        • MarkdownSegment
        • NodeSegment
        • ForwardSegment
        • MusicSegment
        • PokeSegment
        • DiceSegment
        • RpsSegment
        • ContactSegment
        • ShakeSegment
        • KeyboardSegment
        • KeyboardButton
      • _
        • GroupUploadFile
        • FlashFile
        • MsgEmojiLike
        • 消息发送者
      • 消息
      • 戳一戳
      • 撤回戳一戳
      • 好友消息撤回
      • 好友申请
      • 好友添加
      • 名片点赞
      • 群文件上传
      • 申请加群
      • 群成员新增
      • 群成员减少
      • 群头衔
      • 群名片
      • 群消息贴表情
      • 群消息撤回
      • 群管理员
      • 群禁言
      • 群精华
      • 闪传文件
      • 心跳
      • 生命周期
    • 实体
      • 群文件
      • 群文件夹
  1. 接口列表

Websocket 发送/接受消息

Websocket 连接有正向和反向两种#

正向的意思是 Bot 端为 Websocket 服务器,你的插件需要主动去连接它,
反向的意思是 Bot 端作为客户端,你的插件作为服务端,Bot 端会主动连接你的插件端。

调用接口的方式#

和 Bot 建立 Websocket 链接后,发送一个 JSON
{
    "action": "send_group_msg",
    "params": {
      "group_id": 545402644,
      "message": [
        {
          "type": "text",
          "data": {
            "text": "HelloKitty"
          }
        }
      ]
    },
    "echo": "唯一标识,如 uuid"
}
action 对应的接口名和 HTTP 的一致,具体有哪些接口名可以在左侧接口列表查看。
params 则和 HTTP 接口提交的 JSON 一致。
echo 发送和返回都会带有此字段,用于 Websocket 发送请求后返回的对应,由于 Websocket 是长连接,同一时间可能会有很多返回,因此需要一个唯一标识符,这样才能识别自己调用的接口后返回的数据。
同时这个 Websocket 连接也会接收到 Bot 的消息和事件上报。

下面是一个正向 Websocket 的 Python 示例#

需要先安装 websockets 包,pip install websockets
在 LLOneBot 启用 Websocket 正向,并填入端口 3001。
然后运行上面的 Python 代码,输入群号后开始打印收到的消息,再输入任意内容按回车会往刚刚输入的群号发送消息。

下面是反向 Websocket 的 Python 示例#

需要先安装 websockets 包,pip install websockets
在 LLOneBot 启用 Websocket 反向,并填入反向地址 ws://localhost:8765
运行上面的 Python 代码后,输入群号后开始打印收到的消息,再输入任意内容按回车会往刚刚输入的群号发送消息。
修改于 2025-08-22 12:36:56
上一页
HTTP 调用/接收消息
下一页
点赞
Built with