OMG-Agent：Mac 安卓设备自动化助手

软件介绍

OMG-Agent 是通过自然语言任务操作 Android 设备的桌面客户端。Mac 作为控制端，通过 ADB 获取设备画面、执行交互，再由配置的 GUI 模型决定后续步骤，可用于移动界面自动化研究与测试。

项目提供源码，但并不等于允许任意商业使用；开始部署前须阅读项目许可与使用限制。

环境与设备准备

先准备 Homebrew、Git 及符合项目要求的 Python 环境。依赖建议安装在独立 Python 虚拟环境中，避免与其他项目混用。macOS 的 ADB 安装命令如下：

brew install android-platform-tools

1. 仅在自己的或已获授权的 Android 设备上启用开发者选项与 USB 调试。
2. 按项目说明安装 ADBKeyboard 输入法，并了解其输入权限。
3. 通过 USB 连接设备，只向可信的 Mac 授予调试授权。

在已准备好的 Python 环境中，按源文安装并启动项目：

git clone https://github.com/safphere/OMG-Agent.git
cd OMG-Agent
pip install -r requirements.txt
python run.py

模型配置

项目支持 AutoGLM、GELab-Zero 等手机 GUI 模型，以及兼容 OpenAI 接口的服务。选择端点、模型名及 API 凭据时，应使用实际服务提供的配置，不把不同模型的请求格式混用。

模型可以在不同位置运行；使用在线端点可能产生费用。不要把 API Key 写进任务文本、公开截图或代码仓库。

任务执行

1. 启动客户端后刷新设备列表，确认选中正确的手机或模拟器。
2. 开始投屏，先检查连接与画面是否正常。
3. 先执行打开应用、查看页面等低风险任务，观察模型的每一步操作。
4. 发生误点、循环或跳转到非目标应用时及时停止，缩小任务后再测试。

发送消息、删除文件、修改账户或付款等操作不应无人看管执行；先确认对象与后果，再人工接管关键步骤。

数据与操作边界

截图、任务描述及界面中的文字可能发送给所配置的模型服务。使用测试账号和脱敏内容，不在包含密码、验证码、支付或他人隐私的界面直接试验。

作者说明将项目限定用于学习、研究与技术探索，禁止商业使用；仓库许可包含 Apache 2.0 与 Commons Clause 附加限制。应同时遵守设备和应用的服务条款，不能据“提供源码”推断商业授权。

测试结束后撤销不再需要的 USB 调试授权，检查输入法和模型凭据设置。

项目与下载

使用声明

本文由 MENTUKEJI 根据项目官网、官方文档及公开资料整理。工具功能、价格、授权方式及服务条款可能随时调整，请以官方最新信息为准。

引用本文内容请注明来源并保留原文链接；如需全文转载，或发现内容错误、版权及授权问题，请联系：[email protected]。