OpenShamrock 搭建 QQ 机器人：从装 LSPosed 到跑通 OneBot 11 的完整指南

OpenShamrock 搭建 QQ 机器人从装 LSPosed 到跑通 OneBot 11 的完整指南【免费下载链接】OpenShamrockA Bot Framework based on Xposed with OneBot11项目地址: https://gitcode.com/gh_mirrors/op/OpenShamrock写过 go-cqhttp 的人大概都懂这种折腾协议端要自己登录、自己保活服务器还得单独开一台。OpenShamrock 是另一条路——一个基于 LSPosed 和 Xposed 的 QQ 机器人框架直接跑在真实 QQ 客户端里对外提供 OneBot 11 标准接口你的手机 QQ 本身就是协议端。一句话讲清 OpenShamrock 是什么它基于 LSPosed非 Riru框架通过 Xposed 钩子接管 QQ 客户端内部的 NT 服务对外封装出消息、群组、好友等标准服务实现 OneBot 11/12 协议能力。和传统协议端最大的区别是不再单独维护一个登录进程已经登录的 QQ 就是机器人本体。动手部署QQ 机器人部署步骤装好 LSPosed 和模块设备 root 后先装 LSPosed 管理器再安装 OpenShamrock 的 APK。QQ 客户端要求 9.0.70 以上项目已明确低版本不再修复装之前先升级 QQ。装完模块后下一步是让 LSPosed 知道该把钩子打进哪个进程。把模块作用域指到 QQ在 LSPosed 管理器的模块设置里把作用域勾上 QQ由于模块需要保活通常还要一并勾选系统框架。改完作用域重启应用或重启设备等 QQ 重新登录。QQ 重新登录后钩子已经就位但机器人框架还连不进来得把 RPC 打开。打开配置面板接上 RPC默认配置对应 config 目录 里的一组开关类。主动 RPC 默认监听 5700 端口被动 RPC 则填你的服务器地址两边都支持设置鉴权 token别留空。用机器人框架连上来拿 Koishi、NoneBot 这类 OneBot 框架指向你配好的地址和端口连上之后发一条消息给自己的 QQ收得到就说明整条链路通了。核心能力逐条拆解消息服务——发、撤、长消息都归它管MessageService.kt 把发送逻辑挂在客户端真实发送通道上私聊、群、频道、陌生人会话都能发也支持撤回和标记已读。客服场景下自动回复超长文本时它会走长消息资源上传再按 ID 发送不截断。群服务——禁言、踢人、改卡片一步到位GroupService.kt 覆盖最常用的群管理接口禁言、踢人、设管理员、改群名片、拉禁言名单和查剩余 全体成员 次数。五百人大群里拉取成员列表是分段的不会出现一次调用直接超时的情况。好友服务——资料卡与 UID 互查FriendService.kt 提供好友列表、资料卡读取、UID/UIN 互转和资料卡设置。机器人要根据转发来的名片识别对方身份时直接调用 UID 转换接口就行。配置体系——开关都在明面上平板模式、反 JVM 调用栈跟踪、调试模式这些行为开关都是独立的配置类出问题时顺着配置名就能定位是哪一项导致的不用翻日志猜。三个真实场景商家群里顾客发「查单」机器人通过消息事件拦截调业务接口后把快递单号私聊回给对方群消息流不受打扰。机器人有管理员权限时成员刷屏违规它自动读群名片、禁言十分钟、本人并附违规记录整个处理在几秒内完成。每天早上九点机器人定时往运营群推晨报文本超过单条长度限制就自动拆成多条按顺序发完。部署后最容易踩的三个坑QQ 版本号低于 9.0.70 时模块不加载现象是模块装了、作用域勾了日志却什么都没有。原因是框架只支持 9.0.70 以上版本低版本问题官方不再处理。解法只有一个升级 QQ。旧 Riru 环境下模块无反应LSPosed 走的是非 Rilu 路径老设备上残留 Riru 环境时模块可能根本不注入。把环境切到 LSPosed非 Riru或整体升级 Xposed 生态再试。机器人框架连不上 5700 端口主动 RPC 开着但连接超时多半是 token 没配对或防火墙拦了 5700。核对配置里的端口和票据网络隔离严重的话改用被动 RPC让框架反向连进来。周边生态怎么接项目接口按 go-cqhttp 的文档实现兼容 OneBot 11 和 12 两套标准现有机器人框架一般不用改代码就能接。协议层的数据结构集中在 protobuf 目录消息的转换与处理逻辑在 msg 目录要扩展自定义消息类型时从这两处入手。你可能想问Q: 模拟器上能不能跑A: 可以前提是模拟器支持 LSPosed并且网络模式设为桥接否则主动 RPC 基本连不通。Q: 必须要 root 吗A: 要LSPosed 依赖 root 环境。建议用专门的 QQ 小号跑机器人主账号风险太高。Q: 我的机器人框架用的是 OneBot 12 标准兼容吗A: 兼容OpenShamrock 同时实现了 OneBot 11 和 12按你框架需要的标准连就行。Q: 多台手机能装同一个模块吗A: 能每台设备都是一个独立协议端框架侧可以并行挂接多个。Q: 需要自己编译 APK 吗A: 一般不用直接装发布版本日常只改配置文件就够了。如果你手上正好有一台 root 过的设备现在就可以去 LSPosed 管理器里确认作用域再用机器人框架连上 5700 端口第一条消息离你不远。账号记得用专门的小号主号别碰。【免费下载链接】OpenShamrockA Bot Framework based on Xposed with OneBot11项目地址: https://gitcode.com/gh_mirrors/op/OpenShamrock创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考