OpenShamrock快速上手指南把手机变成OneBot 11的QQ机器人框架【免费下载链接】OpenShamrockA Bot Framework based on Xposed with OneBot11项目地址: https://gitcode.com/gh_mirrors/op/OpenShamrockOpenShamrock 是一个基于 LSPosed 模块实现的 QQ 机器人框架在真实 QQ 里登录后它对外暴露 OneBot 11/12 标准接口机器人生态通用的消息协议规范可以接入任何 OneBot 机器人程序。适合想在真机上跑机器人、或从 go-cqhttp 迁移的用户。读完本文你可以完成部署并连上自己的机器人程序。 它解决什么问题迁移现有机器人项目按 go-cqhttp 的文档实现接口你原来用 OneBot 客户端写的机器人代码通常不用改只把连接地址和 token 指向跑 QQ 的那台机器。机器人跑在真机 QQ 上模块注入 QQ 进程运行消息收发走真实 QQ 客户端行为与真人登录一致可用到语音、图片、文件等客户端能力。事件驱动收到私聊/群消息、好友申请、加群申请、群管理变更、消息撤回等都会以 OneBot 事件推送给你的程序写监听逻辑即可。语音消息解码仓库自带完整的 Silk 语音编解码源码cpp/ 目录语音消息可以还原成可播放的音频。 OpenShamrock 安装步骤与首次跑通前置条件已 root 的安卓设备或支持 LSPosed 的模拟器并已装好 LSPosed 框架QQ 版本 9.0.70 及以上安装模块安装 OpenShamrock 的 release 包 APK在 LSPosed 管理器中启用该模块作用域勾选系统和QQ两项——系统作用域用于息屏保活不能省重启设备打开 QQ 并登录一个账号首次跑通的判定QQ 登录成功后模块在进程内启动一个本地 gRPC 服务默认端口 5700日志出现KritorServer started at port 5700即部署成功让模块把事件推给你的服务器配置里设passive_rpctrue并填rpc_address反向 WebSocket让你的客户端主动连模块设active_rpctrue并在active_ticket填鉴权 token各项配置的默认模板见 xposed/src/main/assets/config.properties每行都有中文注释 看懂三个设计点LSPosed 而非 Riru。README 明确提示 Riru 可能导致封号因此项目选择 Non-Riru 的 LSPosed 路线。模块只在 QQ 进程加载时挂钩另外挂钩android系统包防止息屏后服务被杀。对使用者意味着作用域必须包含系统息屏一段时间后机器人掉线先查作用域配置。进程内 gRPC 服务层。核心在 xposed/src/main/java/kritor/service/消息、好友、群组、群文件、Web、QSign 等 10 个服务注册在一个本地 gRPC 服务器上每个方法用Grpc注解标记由仓库内的 KSP 编译器插件在构建期生成注册代码。对使用者意味着接口对外始终是 OneBot 标准QQ 实现细节被封装在服务层内部新增能力就是加一个服务方法。协议层独立成模块。protobuf/src/main/java/protobuf/ 下是 QQ 消息体、路由头、OIDB 指令的 protobuf 定义发消息时由转换器把 OneBot 元素转成 NT QQ 消息。对使用者意味着正常使用完全不需要碰协议做协议研究时这个目录就是入口。⚠️ OpenShamrock 常见坑与安全注意QQ 版本仅支持 9.0.70 以上低版本问题项目声明不再修复别在旧版上浪费时间。专用号运行Xposed 环境本身有封号风险不要用主号跑机器人。作用域漏勾选息屏即掉线绝大多数是系统作用域没勾上。token 不能省开了active_rpc却不设active_ticket同一局域网内任何人都能操作你的机器人。模拟器网络把网络模式设为桥接否则服务器连不到 5700 端口。权限基线项目只声明网络、Hook 系统框架防杀、后台启动 Activity 三类权限出现未声明的权限要求说明 APK 被改过直接弃用。✅ 下一步OpenShamrock 是注入真实 QQ 客户端路线的 OneBot 11/12 实现适合真机行为和客户端能力优先的场景。下一步执行git clone https://gitcode.com/gh_mirrors/op/OpenShamrock拉取源码从 xposed/src/main/java/kritor/ 的服务层读起遇到问题按 README 指引查阅官方文档站点与项目社区。【免费下载链接】OpenShamrockA Bot Framework based on Xposed with OneBot11项目地址: https://gitcode.com/gh_mirrors/op/OpenShamrock创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考