LSPosed QQ机器人怎么搭？OpenShamrock从安装到跑通的全流程

LSPosed QQ机器人怎么搭？OpenShamrock从安装到跑通的全流程

【免费下载链接】OpenShamrockA Bot Framework based on Xposed with OneBot11项目地址: https://gitcode.com/gh_mirrors/op/OpenShamrock

OpenShamrock是基于LSPosed框架的QQ机器人框架，注入真实QQ客户端运行，对外说OneBot 11/12协议。有root手机、想做自动回复或群管理机器人？这篇带你从装好到跑通。

它到底是什么：一半是注入，一半是协议

用一句话说透 OpenShamrock：下半身是 Xposed 注入，上半身是标准协议。底层通过 LSPosed 模块挂进 QQ 进程，直接复用 QQ 自带的登录态和消息链路，不用自己伪造客户端协议——项目也明确不走 Riru 路线，原因正是 Riru 更容易触发账号风险。上层则把这些注入能力统一封装成 OneBot 11/12 标准接口，现有 OneBot 生态基本可以接着用。打个比方：QQ 负责"通"，OpenShamrock 负责把通的能力翻译成标准接口，你的业务代码只需要对接 OneBot 这一层。

安装与作用域设置步骤

先核对环境，四条全过再动手：

• 设备已 root，并装好 LSPosed 框架与其管理器；
• QQ 版本 9.0.70 及以上，低于这个版本不受支持，问题也不再处理；
• 下载模块 APK 并安装到手机；
• 打开 LSPosed 管理器进入模块作用域，把"系统"和"QQ"两个勾都打上，缺一个模块都不会生效。

设置完重启手机，再登录 QQ，机器人服务会随 QQ 一起启动。后面调网络、改行为，基本都落在 assets 目录下的 config.properties 这一个文件里，建议先把它翻一遍。

正向与反向WebSocket怎么选

你的代码要收到机器人转发的消息，有两条通道，按服务端的位置来选：

正向 WebSocket（配置里的 active_rpc）：机器人在手机端开服务，默认监听 5700 端口，由你的服务器主动连过来。适合手机与服务器在同一局域网、或手机那端更稳定的场景。

反向 WebSocket（passive_rpc）：机器人主动拨号到你的服务器，只需填两行：

passive_rpc=true rpc_address=ws://192.168.1.10:3001

手机端往往在 NAT 后面，往外连比被连更靠谱，所以实际用得更多的是这条。无论走哪条，都建议设置鉴权 token 校验连接来源，配置文件支持配多个 token 区分不同接入方。

功能模块与典型用例：消息、好友、群组各管一段

服务层按业务拆得很开：消息服务 管消息收发，好友服务 管好友列表与私聊，群组服务 管成员、公告等群事务。协议层则单独放在 protobuf 目录，与 QQ 服务器通信用的数据结构都定义在那里，协议和业务互不干扰，扩功能时通常只动服务层。

结合模块看，三个最实用的玩法：关键词客服——收到消息先查预设答案表再回复；群管理助手——定时发群公告、同步成员变动；定时任务——每天定点推送天气、会议提醒或新闻。这些都不需要碰协议层，取对应服务类就行。

避坑手册：先过这四关

🛑 写第一行业务代码前，先把这四件事做掉。

用专用小号。主号跑机器人风险很高，建议专门注册一个号，出问题弃号损失也小。

模拟器先查网络模式。机器人连不上局域网里的服务时，多半该把网络切成桥接模式，否则很可能卡在连接这一步。

设好超时与重试。手机网络并不总在线，断线后的重连逻辑和合理的超时参数，决定了机器人是"断了能活"还是"一断就死"。

备份配置。config.properties 是机器人行为的总开关，改动前先复制一份，方便随时回滚。

常见问题

Q：支持哪些 QQ 版本？A：9.0.70 及以上。低于该版本的问题官方不再处理，别指望跑通。

Q：必须 root 吗？A：必须。LSPosed 本身就依赖 root 权限注入，无 root 设备绕不过去。

Q：模拟器上能跑吗？A：能，前提是模拟器支持 LSPosed，且网络模式改桥接，之后按正常流程配置即可。

Q：反向 WS 连上了，但收不到消息？A：按顺序查三处：token 是否一致、服务端是否真的收到连接、机器人端的 QQ 是否已登录。多数"连不上"最后都是防火墙或超时参数的问题。

Q：现有的 OneBot 项目能直接迁过来吗？A：OneBot 11/12 接口是兼容的，基于 go-cqhttp 那套接口的代码基本原样可用，迁移成本主要在部署侧。

写在最后

OpenShamrock 的思路不复杂：LSPosed 挂进 QQ，OneBot 统一对外接口，中间留给你写业务逻辑的空间。第一次上手，建议按这个顺序来：备一个小号，把 QQ 升到 9.0.70 以上，配好反向 WebSocket 确认事件能正常收到，然后再考虑加功能。

【免费下载链接】OpenShamrockA Bot Framework based on Xposed with OneBot11项目地址: https://gitcode.com/gh_mirrors/op/OpenShamrock