WorkTool 企业微信机器人部署与长期运行实操指南

WorkTool 企业微信机器人部署与长期运行实操指南

【免费下载链接】worktool一款安全稳定的Android无障碍服务工具，支持控制企微/微信来运行的无人值守群管理企业微信机器人项目地址: https://gitcode.com/GitHub_Trending/wo/worktool

想让企业微信账号无人值守地收发消息、建群拉人，一台安卓手机装上 WorkTool 即可。本文按最小部署、关键配置、排错三条线展开，给出每步的成功标志与常见失败点，适合要长期运行企业微信机器人的人。

适用场景与前置条件

这类工具适合以下场景：

• 群内自动应答：群成员 @ 机器人账号时按策略回复，效果见上方截图。
• 无人值守的群与联系人管理：自动通过好友请求和群邀请、建群拉人、回调群二维码。
• 任务驱动执行：调度平台经 WebSocket 下发指令，App 顺序执行并回传结果。

前置要求均可在仓库中查证：Android 7.0（API 24）及以上，无需 Root；已安装并登录企业微信，且版本在适配列表内——开源代码的列表是 Constant.kt 中的AVAILABLE_VERSION（4.0.2~4.1.10），README.md 标注打包版兼容 4.1.8~4.1.39、5.0.0~5.0.10；需授予无障碍服务、显示在其他应用上层、存储三类权限。

不适用：账号有被封或禁言记录的，README 明确提示不要使用本工具；此开源代码的检测目标仅为企业微信包名com.tencent.wework。

安装到跑通：最小必要步骤

1. 装包并核对运行环境

• 做什么：开发者从源码编译，或从 README 入口下载打包版安装。
• 成功标志：首页（ListenActivity）版本区显示应用版本、系统版本与设备型号；若检测到设备已 Root 或存在 hook 代码，会给出明确警示，此时不要继续使用。

2. 填写链接号并保存

• 做什么：在首页输入框填写机器人链接号（robotId）并保存。
• 成功标志：提示“保存成功”；链接号未填时，开启无障碍的开关会被拦下，提示“请先填写并保存链接号”。

3. 授权系统无障碍能力

• 做什么：点击首页无障碍开关，程序跳转系统设置，在无障碍服务列表中打开 WorkTool。
• 成功标志：返回首页后开关回显为开启；WeworkService.kt 此时作为 AccessibilityService 连接成功，并建立到调度平台的 WebSocket 长连接。

4. 授予悬浮窗并启动

• 做什么：打开悬浮窗开关授予权限，出现悬浮窗后点其上的播放按钮启动。
• 成功标志：弹出“设置成功，请勿人工操作手机，5 秒后自动跳转”并自动拉起企业微信，期间不要手动操作。

长连接验证：在首页点 host 区域切换地址、或长按添加专线，程序会自动跑一次连接测试（HostTestHelper.testWs），用 toast 展示 WebSocket 回调状态。

关键配置项与默认值一览

参数均定义在 Constant.kt 中，带本地默认值；App 启动后会按 robotId 从调度平台拉取机器人配置（getMyConfig）。

连接参数

• host：默认wss://api.worktool.ymdyes.cn；点按切换已保存地址，长按添加专线（须为 ws/wss 格式）。专线部署只改这一项。
• robotId：链接号，长连接地址为{host}/webserver/wework/{robotId}。
• encryptType：默认 0。

消息处理策略

• replyStrategy：默认 1（只回复 @），0 为不回复，2 为回复所有。
• duplicationFilter：默认开，过滤 API 重复推送，降低重复回复风险。
• autoPassFriendRequest：默认开；好友请求需人工审核时关闭。

群组行为

• groupStrict：默认关，群组严格模式。
• fullGroupName：默认开，获取群聊全称。
• groupQrCode：默认关，是否回调群二维码。
• autoPublishComment：默认开。

运行节奏

• LONG_INTERVAL默认 5000ms、CHANGE_PAGE_INTERVAL默认 1000ms、POP_WINDOW_INTERVAL默认 500ms，分别控制长时操作、翻页与弹窗处理节奏。
• oldDevice：默认关；老手机响应慢时打开可放慢节奏。
• 建议不要把间隔改得过小——无障碍操作依赖页面渲染完成，过快会抬高误识别概率。

运行稳定性与排错

日志在哪看

LogUtilsInit.kt 默认开启文件日志，保留 7 天，文件写入应用 cache/log/ 目录，可在应用内分享；运行期错误还会经 WebSocket 实时上报调度平台，平台侧同样可查。

ANR 与异常自动恢复机制

• 企业微信 ANR：系统 ANR 对话框弹出时，程序检测“关闭应用”“等待”按钮并自动点击处理，见 GlobalMethod.kt。
• 离开前台：getRoot()检测到前台不是企业微信时自动重新拉起。
• 登录失效：检测到“手机号登录”页面时自动关闭主功能，并提示先完成登录。

常见失败点与自查

• 版本不适配：首页版本区会明示“可能存在部分兼容性问题”，先把企业微信换到列表内版本。
• 服务未真正连接：开关已开但 cache/log 中没有“初始化成功”，检查系统是否杀掉了服务。
• 悬浮窗不出现：悬浮窗权限未真正授予，回到首页悬浮窗开关重新授权。
• 长连接不通：核对 host 与 robotId，用前文的连接测试观察回调。

合规与风险提醒

• README 明确提示：账号曾有被封或禁言记录者不要使用本工具；使用行为违反腾讯运营规范或法律的，不应使用本工具。
• 程序自带环境检测：存在 hook 代码的设备会被明示拒绝运行，Root 设备会展示风险提示。
• 开源仓库为历史版本（v2.8.1），商业版持续更新并适配新版企业微信；长期运行的关键，是让工具版本与企业微信版本保持匹配。
• 工具基于 Android 系统无障碍服务实现，使用范围请限于自身企业的合规业务场景。

机器人能不能长期在线，取决于部署是否可观测：每次启动先看首页的版本提示与长连接回调，再定期翻 cache/log 目录。参数定义见 Constant.kt，版本历史见仓库 README.md。

【免费下载链接】worktool一款安全稳定的Android无障碍服务工具，支持控制企微/微信来运行的无人值守群管理企业微信机器人项目地址: https://gitcode.com/GitHub_Trending/wo/worktool