10分钟跑通你的第一个QQ机器人OpenShamrock 手把手安装配置【免费下载链接】OpenShamrockA Bot Framework based on Xposed with OneBot11项目地址: https://gitcode.com/gh_mirrors/op/OpenShamrockOpenShamrock 是一款基于 Xposed 和 LSPosed 实现 OneBot 11 标准的 QQ 机器人框架让已 Root 的安卓手机上的 QQ 账号直接接入机器人程序自动回复、群管理、定时任务都能实现不需要再维护独立的协议端账号。这篇教程带你在 10 分钟内从环境自检走到 API 跑通完成一次完整部署。 它到底能帮你做什么你定一条规则群里有人 机器人 它就自动应答新人进群它自动打招呼。你排一个定时任务每天早上九点机器人替你往群里发提醒。你已有的 OneBot 程序可以直接接进这个框架机器人代码不用重写换个 QQ 端就能跑。✅ 动手前的环境自检清单一台已 Root 的安卓手机或模拟器终端里执行su不再弹权限拒绝才算已 RootLSPosed 框架已安装并激活打开 LSPosed 应用主页能看到已激活状态QQ 版本 9.0.70 及以上点我的→ 设置 → 关于 QQ 查看版本号项目明确不支持低版本一个能正常登录的 QQ 账号就是你要变成机器人账号的那个一台与手机同网段的电脑装好 Postman 或 curl用来验证 API 是否可用 从零到跑通的完整安装流程安装并激活 LSPosed 框架LSPosed 是让整个流程成立的 Hook 框架OpenShamrock 靠它把代码注入 QQ。在已 Root 的手机里装好 LSPosed 应用后进它的主页点安装器选择你的 Root 方案Magisk 或 KernelSU完成安装并重启手机。重启后 LSPosed 主页出现绿色已激活标识说明框架已就绪后面的一切才能成立。安装 OpenShamrock 主程序从项目源码仓库的 Releases 页面下载最新版 APK 传到手机里安装即可。如果你习惯追最新代码也可以把源码拉到本地自己构建git clone https://gitcode.com/gh_mirrors/op/OpenShamrock桌面出现 OpenShamrock 图标就说明装好了。主程序和 Hook 模块打在同一个 APK 里不用再单独下载第二份。启用模块并勾选 QQ 应用打开 LSPosed 应用在模块列表里找到 OpenShamrock打开它的开关再点下方的选择应用图标只勾选QQ这一项后保存。模块条目上出现需要重启标记即表示配置完成——这一步的作用是让框架知道只往 QQ 这一个应用里注入 Hook 代码。登录 QQ 并确认初始化完成把 QQ 从后台彻底划掉重新打开并登录目标账号等待一两分钟。接着用文件管理器打开Android/data/com.tencent.mobileqq/files/Tencent/Shamrock/目录能看到config.prop文件就说明模块初始化成功这个文件就是下面所有配置项的入口。⚙️ 必须搞懂的 3 个核心配置项下面 4 项都在config.prop里也可以在 OpenShamrock 应用内的设置页改改完必须重启 QQ 才生效。配置项作用推荐值改错的后果active_rpc对外暴露 HTTP API 的开关true保持默认false时端口根本不开机器人客户端连上就超时rpc_portAPI 监听端口号5700撞上别的应用占用的端口就启动失败换一个空闲端口active_ticketAPI 鉴权 token自拟随机串如a1b2c3留空时局域网内任何程序都能调用你的机器人 APIresource_group存放语音等媒体资源的群组默认883536416或你有管理权的群填了不在的群语音消息会下载失败⚠️ 踩坑预警新手最容易翻车的几个点症状QQ 闪退或打不开现象模块启用后 QQ 一启动就闪退。原因QQ 版本低于 9.0.70或者模块被误开在了 QQ 以外的应用上。解决把 QQ 升到 9.0.70 以上并在 LSPosed 的选择应用里确认只勾选了 QQ。症状登录 QQ 后 config.prop 没出现现象登录并等待后Shamrock 目录一直没生成。原因模块没真正加载最常见是 LSPosed 激活后 QQ 没有完整重启过。解决彻底划掉 QQ 再打开还不行就打开 OpenShamrock 应用的日志页看报错。症状API 调用超时现象active_rpc已设为true但 curl 或机器人客户端连不上。原因active_ticket没填或者机器人那一端填的 ticket 和配置文件对不上。解决给active_ticket填一个随机串保证两端完全一致重启 QQ 再测。项目仅供 Hook 框架的学习与研究使用时留意平台规则与账号本身的风控即可。装完之后顺手做这几件事打开passive_rpc把 API 反向推送到远程服务器机器人逻辑就不必再依赖手机在线。开启alive_reply让机器人对自己的消息自动回复避免被群里的闲聊刷屏。接上 NoneBot 之类的机器人框架开始写真正的群管理和定时任务逻辑。仓库根目录的 README 和源码里还有语音支持等进阶玩法可以挖。当你的机器人对第一条测试消息做出回复时部署就结束了——剩下的逻辑全归你写。【免费下载链接】OpenShamrockA Bot Framework based on Xposed with OneBot11项目地址: https://gitcode.com/gh_mirrors/op/OpenShamrock创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考