LLOneBot
主页部署文档
主页部署文档
  1. 接口列表
  • 部署文档
  • OneBot 11
    • OneBot 11 接口说明
    • 接口列表
      • HTTP 调用/接收消息
      • Websocket 发送/接受消息
      • 用户
        • 点赞
        • 好友列表
        • 好友列表(带分组)
        • 删除好友
        • 处理好友申请
        • 设置好友备注
        • 获取好友或群友信息
        • 设置个人头像
        • 好友戳一戳(双击头像)
        • 获取我赞过谁列表
        • 获取谁赞过我列表
        • 获取官方机器人QQ号范围
        • 移动好友分组
        • 获取QQ头像
        • 获取被过滤好友请求
        • 处理被过滤好友请求
      • 群组
        • 群列表
        • 群详情
        • 群成员列表
        • 获取群成员信息
        • 群员戳一戳(双击头像)
        • 获取群系统消息
        • 处理加群请求
        • 退群
        • 设置群管理员
        • 设置群名片
        • 群禁言
        • 群全体禁言
        • 获取被禁言群员列表
        • 设置群名
        • 批量踢出群成员
        • 群踢人
        • 设置群头衔
        • 群荣誉
        • 获取群精华消息
        • 设置群精华消息
        • 删除群精华消息
        • 获取群 @全体成员 剩余次数
        • 发送群公告
        • 获取群公告
        • 群打卡
        • 设置群消息接收方式
        • 设置群备注
        • 获取已过滤的加群通知
      • 消息
        • 发送私聊消息
          • 发送私聊文本消息
          • 发送私聊回复消息
          • 发送私聊图片
          • 发送私聊文字+图片
          • 发送私聊系统表情
          • 发送私聊语音消息
          • 发送私聊视频消息
          • 发送私聊超级表情 骰子
          • 发送私聊超级表情 猜拳
          • 发送私聊QQ音乐卡片
          • 发送私聊网易云音乐卡片
          • 发送私聊自定义音乐卡片
          • 发送私聊卡片(json)消息
          • 发送私聊合并转发消息
        • 发送群聊消息
          • 发送群聊文本消息
          • 发送群聊回复消息
          • 发送群聊@消息
          • 发送群聊图片
          • 发送群聊文字+图片
          • 发送群聊系统表情
          • 发送群聊语音消息
          • 发送群聊视频消息
          • 发送群聊超级表情 骰子
          • 发送群聊超级表情 猜拳
          • 发送群聊QQ音乐卡片
          • 发送群聊网易云音乐卡片
          • 发送群聊自定义音乐卡片
          • 发送群聊卡片(json)消息
          • 发送群聊合并转发消息
        • 长连接接收消息
        • 转发单条好友消息
        • 转发单条群消息
        • 获取消息详情
        • 撤回消息
        • 获取消息文件详情
        • 获取消息图片详情
        • 获取消息语音详情
        • 表情回应消息
        • 取消消息表情回应
        • 获取好友历史消息记录
        • 获取群历史消息
        • 获取转发消息详情
        • 标记消息已读
        • 语音消息转文字
        • 发送群 Ai 语音
      • 文件
        • 上传群文件
        • 群文件转永久
        • 删除群文件
        • 移动群文件
        • 创建群文件文件夹
        • 删除群文件文件夹
        • 获取群文件系统信息
        • 获取群根目录文件列表
        • 获取群子目录文件列表
        • 重命名群文件文件夹名
        • 获取群文件资源链接
        • 获取私聊文件资源链接
        • 上传私聊文件
        • 上传闪传文件
        • 下载闪传文件
        • 获取闪传文件详情
        • 下载文件到缓存目录
      • 系统
        • 获取登录号信息
        • 获取版本信息
        • bot状态
        • 清理缓存
        • 获取cookies
        • 设置在线状态
        • 重启
      • 其他
        • 图片 OCR
        • 获取图片rkey
        • 获取推荐表情
        • 获取收藏表情
        • 获取群 Ai 语音可用声色列表
        • 发送Protobuf数据包
  • Satori
    • Satori 接口说明
  • 数据模型
    • 上报事件
      • 消息段
        • 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