企业官网建设流程全解析

从零跑通 OpenShamrock 安装：QQ 机器人框架 5 步部署指南

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

OpenShamrock 是基于 Xposed 的 QQ 机器人框架，安装后把手机里的 QQ 直接变成可编程的机器人入口。本文写给刚接触 Lsposed 的新手和想多端部署的中级用户，跟着走就能把服务跑起来。前置条件一句话：设备已 Root，QQ 不低于 9.0.70。

先搞懂 OpenShamrock 是什么

它不模拟登录，而是以 Lsposed 模块的身份住进 QQ 内部干活——相当于给 QQ 装了个遥控器：逻辑写在外部程序里，动作由 QQ 本尊执行，能力按 Kritor 标准（一套机器人能力接口规范）暴露。

• Lsposed（Xposed 的轻量替代，负责系统级 Hook）
• Xposed（让第三方代码插进 App 内部运行的框架）
• OneBot11（机器人消息接口标准，统一发消息、管群这类操作的写法）
• Kotlin / C（应用主体逻辑与 Silk 语音解码）

环境自检清单

• 设备已 Root（Root 管理器里确认授权已激活）⚠️ 没有它 Lsposed 装不了，后面全白搭
• 已装 Lsposed 并激活（Lsposed 首页能看到激活状态）
• QQ 版本 ≥ 9.0.70（设置 → 关于 QQ 查看，低版本模块不生效）
• 已下载 OpenShamrock 的 APK（项目 Releases 页拿最新包）

安装流程：5 步部署 QQ 机器人框架

获取 OpenShamrock 安装包

默认从项目 Releases 下载最新 APK；要源码编译时，clone 仓库后执行打包命令：

git clone https://gitcode.com/gh_mirrors/op/OpenShamrock ./gradlew assembleDebug

安装 APK 并在 Lsposed 中激活模块

装好 APK 后，打开 Lsposed 的"模块"页勾选 OpenShamrock，目标应用只勾 QQ，然后重启设备。

重启设备并登录 QQ

正常登录 QQ，能进首页、聊天不闪退，说明模块加载成功。

初始化应用并进入配置页

首次打开 OpenShamrock 应用按提示走完引导，后续所有选项都在设置页里调。

打开 API 服务

在设置里开启 active_rpc（主动 RPC，即对外提供 HTTP API 的开关），填好端口与鉴权 token，服务随即就绪。

关键配置项速查

最容易配错的是 active_ticket：机器人端与 OpenShamrock 端必须一字不差，留空等于不设防。

跑起来之后

给绑定的 QQ 号发条消息，机器人端收到对应事件；再用 API 发一条，消息出现在聊天框里，整条链路就算跑通了。

• ⚠️ QQ 未登录时重启设备：模块会加载但服务起不来，先回 QQ 重新登录再测。
• ⚠️ 息屏久了 QQ 被系统杀掉，API 直接失联，记得给 QQ 锁后台、关后台清理。

有问题先翻项目仓库自带的官方文档，或到项目社区提问。

⚠️ 仅供学习交流

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