AutoGLM-Termux 部署工具
🌐 切换到英文文档 / Switch to English Documentation
在安卓手机上通过 Termux 快速部署 Open-AutoGLM 智能体，无需ROOT或电脑等其他设备，即可实现手机自动化操作！
📖 项目简介
AutoGLM-Termux 是一个专为 Termux 环境优化的 Open-AutoGLM 一键部署解决方案。它通过纯 ADB 方案，让你的安卓手机化身 AI 智能体，能够：
- 理解自然语言指令
- 自动执行手机操作（点击、滑动、输入等）
- 支持 50+ 款主流中文 App
- 增强 ADB 设备管理：支持多设备切换、快速连接、设备状态监控
- 一键卸载功能：完整卸载项目及运行环境
- 完全无线控制，无需 Root 或PC等其他设备
- 全面国际化支持，支持中英文切换
- 新增：支持语音识别输入，可通过语音控制手机
⚠️ 合规声明：本项目仅供学习和研究使用，严禁用于任何违法活动。请遵守 Open-AutoGLM 使用条款。
✨ 功能特性
- 一键部署：自动化安装所有依赖和环境配置
- 智能镜像：自动配置国内 pip 和 Cargo 镜像源，加速下载（支持输入
default使用推荐源） - 无线 ADB：内置 ADB 无线调试配置向导，告别数据线
- 语音识别：支持语音输入指令，解放双手（需要安装 Termux:API）
- ADB 设备管理：可视化设备列表、切换活动设备、断开连接、快速重连
- 交互式菜单：可视化启动面板，管理配置更轻松
- 自动重连：支持 ADB 设备自动检测和连接
- 配置持久化：环境变量自动保存，重启 Termux 无需重新配置
- 多设备支持：同一局域网内，关闭VPN的情况下，可用安卓设备使用无线调试连接其他手机adb实现自动控制其他安卓手机设备，支持管理多个 ADB 设备
- 一键卸载：提供基本卸载和完全卸载两种模式，干净清理不残留
- 新增：多语言支持，可在中文和英文之间自由切换
🍭 部署演示
📱 前置要求
-
安卓手机（Android 11+）需支持无线调试
-
Termux 已安装（下载地址）
-
网络连接：手机和 Termux 设备需在同一 WiFi 网络下
-
API Key：需要智谱 AI 或 ModelScope 的 API Key 或 其他支持图片识别的AI模型
-
语音识别（可选）：如需语音控制功能，需安装 Termux:API 应用
- 下载地址：https://github.com/termux/termux-api/releases/
- 安装后，在 设置-应用管理 内或桌面长按 Termux:API 图标，进入应用权限管理界面，授予麦克风权限
若无法安装上述Termux:API APK，可阅读官方文档：Termux-microphone-record ， Termux:API，在f-droid上尝试下载可用版本
-
ADB Keyboard（必须）：
- 下载地址：https://github.com/senzhk/ADBKeyBoard/blob/master/ADBKeyboard.apk
- 安装后，进入 设置 → 系统 → 语言和输入法 → 虚拟键盘 → 管理键盘，启用 "ADB Keyboard"
- 这是必须步骤，否则无法输入中文
若果无法安装上述ADB Keyboard，可以尝试安装此版本ADB Keyboard：https://github.com/eraycc/AutoGLM-TERMUX/blob/main/ADBKeyboard/ADBKeyboard.apk
🚀 快速开始（推荐）
在 Termux 中执行以下命令，一键完成部署或更新：
# 1. 更新 Termux 包列表
pkg upgrade -y
# 2. 下载部署脚本
curl -O https://raw.githubusercontent.com/eraycc/AutoGLM-TERMUX/refs/heads/main/deploy.sh
# 3. 授予执行权限
chmod +x deploy.sh
# 4. 运行部署脚本
./deploy.sh部署完成后，输入 autoglm 即可启动智能控制面板。
📋 详细部署步骤
如果需要更详细的安装指导，请按照以下步骤操作：
步骤 1：安装 Termux
从 GitHub Releases 下载最新版 Termux APK 并安装。
步骤 2：更新 Termux
首次启动 Termux 后，执行：
pkg upgrade -y步骤 3：设置 termux pkg 下载加速源
执行下面的命令打开 termux 的 pkg 加速源设置 GUI：
- 选择
Mirror group - Rotate between several mirrors (recommended) - 点击 OK 进入，通过上下箭头切换到
Mirrors in Chinese Mainland - All in Chinese Mainland - 再次点击 OK，等待自动配置完成即可
termux-change-repo步骤 4：运行部署脚本
curl -O https://raw.githubusercontent.com/eraycc/AutoGLM-TERMUX/refs/heads/main/deploy.sh
chmod +x deploy.sh
./deploy.sh步骤 5：脚本执行流程
脚本将自动完成以下操作：
- 语言选择：首次运行时会提示选择中文或英文界面
- 安装依赖：Python、pip、Git、Rust、ADB（支持自动检测多种包管理器）
- 配置镜像源：可选配置国内 pip/Cargo 镜像加速（输入
default使用推荐源） - 安装 Python 包：maturin、openai、requests、Pillow（Termux 环境通过 pkg 安装 Pillow）
- 克隆项目：从 GitHub 拉取 Open-AutoGLM 最新代码
- 语音识别配置：可选择是否启用语音控制功能
- 交互式配置：设置 API Key、模型参数等（新增设备 ID 配置）
- ADB Keyboard 提醒：提示安装必需的输入法工具（必须步骤）
- ADB 无线配置：引导完成手机无线调试连接（支持自动检测已连接设备）
- 创建启动器：生成
autoglm快捷命令并自动加入 PATH
🖥️ Web 管理端与常驻服务（独立可选模块）
Web 管理面板模块由a251231基于此一键部署项目独立维护，详细部署文档及issue反馈请查看：AutoGLM-TERMUX-Web
如果需要在局域网内用电脑/平板浏览器管理 AutoGLM（配置、启动/停止、看日志、ADB 配对/连接/切换/断开等），可选安装：
# 安装 Web 管理端
curl -O https://raw.githubusercontent.com/a251231/AutoGLM-TERMUX/refs/heads/main/install_web.sh
chmod +x install_web.sh
./install_web.sh
# 启动 Web（默认 0.0.0.0:8000）
autoglm-web run --host 0.0.0.0 --port 8000
# termux-services 常驻服务（重启自动拉起）
curl -O https://raw.githubusercontent.com/a251231/AutoGLM-TERMUX/refs/heads/main/install_web_service.sh
chmod +x install_web_service.sh
./install_web_service.sh启动后终端会打印 Token，浏览器访问 http://<手机IP>:8000/，粘贴 Token 即可使用。Token 存在 ~/.autoglm/web_token，可用 autoglm-web reset-token 重置。
🎮 使用方法
启动控制面板
autoglm主菜单功能
1. 🚀 使用当前配置启动 # 直接运行 AutoGLM（自动检测设备）
2. 🎤 使用语音识别启动 # 语音输入指令控制手机（需启用语音功能）
3. 📱 ADB 设备管理 # 进入增强的设备管理子菜单
4. ⚙️ 修改 AI 配置 # 修改 API Key、模型等
5. 🎙️ 修改语音识别配置 # 修改语音识别参数
6. 📋 查看支持的应用列表 # 显示支持的 50+ 款 App
7. 🔍 查看详细配置 # 显示当前所有配置信息
8. 🌐 切换语言 / Switch Language # 中英文界面切换
9. 🗑️ 一键卸载 # 进入卸载菜单
0. ❌ 退出 # 退出程序
ADB 设备管理子菜单
1. 📱 配对新设备（配对+连接）
2. ⚡ 快速连接（已配对过）
3. 📋 查看设备详细列表
4. 🔄 切换活动设备
5. 🔌 断开设备连接
6. ❓ ADB Keyboard 安装说明
0. ↩️ 返回主菜单
命令行参数
# 直接启动交互模式（绕过菜单）
autoglm --start 或 autoglm -s
# 单次任务模式
autoglm --start "任务描述" 或 autoglm -s "任务描述"
# ADB 设备管理（进入子菜单）
autoglm --setup-adb
# 快速查看设备列表
autoglm --devices
# 切换活动设备
autoglm --switch-device
# 断开设备连接
autoglm --disconnect
# 修改配置
autoglm --reconfig
# 查看支持的应用
autoglm --list-apps
# 一键卸载（进入卸载菜单）
autoglm --uninstall
# 切换语言
autoglm --lang cn # 切换到中文
autoglm --lang en # 切换到英文
# 语音识别模式（需启用语音功能）
autoglm --voice
# 手动指定参数启动
autoglm --base-url URL --model MODEL --apikey KEY --device-id ID "你的指令"
# 显示帮助
autoglm --help使用示例
# 示例 1：打开美团搜索火锅
autoglm
# 然后在交互界面输入：打开美团搜索附近的火锅店
# 示例 2：语音控制（需启用语音功能）
autoglm --voice
# 按提示说出指令："打开微信发送消息给张三"
# 示例 3：直接执行指令
autoglm --base-url https://open.bigmodel.cn/api/paas/v4 \
--model autoglm-phone \
--apikey sk-xxxxx \
"打开微信发送消息给文件传输助手：Hello World"
# 示例 4：多设备环境下切换到指定设备
autoglm --switch-device
# 或命令行直接指定
autoglm --device-id 192.168.1.100:5555 "打开B站"
# 示例 5：快速查看所有设备状态
autoglm --devices
# 示例 6：切换语言到英文
autoglm --lang en🎯 进阶玩法：自定义扩展应用支持
除了内置的50+款主流应用外，你还可以通过修改配置文件，让AutoGLM支持一键打开更多应用。
准备工作
- 下载并安装MT管理器 下载链接：https://mt2.cn/download/
配置步骤
步骤1：授予MT管理器Termux文件访问权限
- 打开MT管理器，展开侧边栏
- 点击顶部"三个点"更多按钮，选择"添加本地存储"
- 在新界面中再次点击左上角"三个点"，打开侧边栏
- 找到并选择"Termux"（显示可用空间：xx GB）
- 点击"使用此文件夹"授权
步骤2：修改应用配置文件
- 返回MT管理器首页，在侧边栏中找到"Termux Home"
- 进入目录：
Open-AutoGLM/phone_agent/config/ - 打开
apps.py文件 - 定位到
APP_PACKAGES配置字典 - 在字典末尾添加你的自定义应用，格式：
"应用名称": "应用包名"
示例配置
在APP_PACKAGES字典末尾添加：
# 自定义应用
"via": "mark.via",
"浏览器": "mark.via",
"via浏览器": "mark.via",
"米游社": "com.mihoyo.hyperion",
"fclash": "com.follow.clash",
"clash": "com.github.metacubex.clash.meta",
"云原神": "com.miHoYo.cloudgames.ys",
"firefox": "org.mozilla.firefox",
"telegram": "org.telegram.messenger.web",
"kimi": "com.moonshot.kimichat",
"酷狗概念版": "com.kugou.android.lite",
"mt管理器": "bin.mt.plus",
"youtube": "com.google.android.youtube",
# 继续添加更多...注意事项
- 应用包名可通过应用商店链接或第三方工具查询（MT管理器-侧边栏-工具-安装包提取，亦可查看）
- 确保包名准确无误，否则无法打开应用
- 修改前建议备份原始文件
- 部分应用可能需要额外配置才能完全自动化
⚙️ 配置说明
环境变量
部署完成后，配置保存在 ~/.autoglm/config.sh，包含：
变量名 说明 默认值
PHONE_AGENT_BASE_URL API 基础地址 https://open.bigmodel.cn/api/paas/v4
PHONE_AGENT_MODEL 模型名称 autoglm-phone
PHONE_AGENT_API_KEY 你的 API Key sk-your-apikey
PHONE_AGENT_MAX_STEPS 最大执行步数 100
PHONE_AGENT_DEVICE_ID ADB 设备 ID（新增） 自动检测（留空）
PHONE_AGENT_LANG 语言 cn
VOICE_ENABLED 语音识别开关 false
VOICE_API_BASE_URL 语音识别 API 地址 https://api.siliconflow.cn/v1
VOICE_API_MODEL 语音识别模型 FunAudioLLM/SenseVoiceSmall
VOICE_API_KEY 语音识别 API Key sk-your-key
VOICE_MAX_DURATION 最长录音时间 60
新增说明：
PHONE_AGENT_DEVICE_ID: 在多设备环境下指定要控制的设备，格式为 IP:端口 或设备序列号。留空时自动检测唯一在线设备。VOICE_ENABLED: 是否启用语音识别功能VOICE_API_BASE_URL: 语音识别服务的基础地址VOICE_API_MODEL: 使用的语音识别模型VOICE_MAX_DURATION: 单次录音的最长时间（秒）
支持的模型服务（AI模型需要图像识别能力）
-
智谱 BigModel（推荐，目前官方autoglm-phone模型暂时免费）
- Base URL:
https://open.bigmodel.cn/api/paas/v4 - 模型:
autoglm-phone - 注册地址: BigModel AFF 邀请
- 密钥申请：智谱 apikeys
- Base URL:
-
ModelScope 魔搭社区
- Base URL:
https://api-inference.modelscope.cn/v1 - 模型:
ZhipuAI/AutoGLM-Phone-9B - 申请地址: ModelScope 平台
- Base URL:
-
其他自定义 AI API 接入 AutoGLM
- 支持 OpenAI 兼容格式的 API 接口
- 需确保模型具备图像理解能力
-
语音识别服务（可选）
- 需要提供：openai 兼容格式的 AI 语音识别 API
- 推荐平台：硅基流动 AFF 邀请，注册即送 2000 万 Tokens
- Base URL:
https://api.siliconflow.cn/v1 - 推荐模型：
FunAudioLLM/SenseVoiceSmall（当前该模型免费）siliconflow模型价格表 - 密钥申请：SiliconFlow apikey
语音识别也可以使用智谱 BigModel 提供的glm-asr-2512模型，详情可查看官方文档
📦 项目结构
~/
├── Open-AutoGLM/ # 项目代码
├── .autoglm/
│ └── config.sh # 配置文件
├── bin/
│ └── autoglm # 启动脚本（自动加入 PATH）
└── .cargo/
└── config.toml # Cargo 镜像配置
🔍 支持的应用列表
运行 autoglm --list-apps 查看完整列表，主要包括：
- 社交通讯：微信、QQ、微博
- 电商购物：淘宝、京东、拼多多
- 美食外卖：美团、饿了么、肯德基
- 出行旅游：携程、12306、滴滴出行
- 视频娱乐：B站、抖音、爱奇艺
- 音乐音频：网易云音乐、QQ音乐、喜马拉雅
- 生活服务：大众点评、高德地图、百度地图
- 内容社区：小红书、知乎、豆瓣
🗑️ 卸载指南
新增功能：项目提供两种卸载方式，可安全清理安装内容
基本卸载（推荐） 卸载 Open-AutoGLM + autoglm 控制面板
- 可选择性删除：pip依赖、项目目录、命令和配置
- 保留运行环境，不影响其他程序
完全卸载（谨慎使用） 除基本卸载内容外，还可选择卸载：
- 核心 pip 包（maturin、openai、requests、Pillow）
- pip/Cargo 镜像配置
- Termux 系统包（python-pillow、rust、android-tools）
⚠️ 警告：可能影响依赖这些包的其他程序
执行方式：
autoglm --uninstall进入交互式卸载菜单，按需选择即可。
-
adb devices不显示设备或显示未授权- 检查 USB 调试：开发者选项中必须开启 USB 调试 和 无线调试
- 检查网络：确保手机和 Termux 在同一 WiFi 网络
- 授权弹窗：手机上点击 "允许 USB 调试"
- 重新配对：删除旧配对，重新执行
adb pair - 重启 ADB：执行
adb kill-server && adb start-server
-
能打开应用但无法点击或输入
- 开启安全调试：部分手机需要开启 "USB 调试（安全设置）"
- 必须安装 ADB Keyboard：设置 → 语言和输入法 → 启用 ADB Keyboard
- 切换输入法：运行时需切换到 ADB Keyboard（Agent 会自动切换）
-
截图黑屏
- 敏感页面：支付、银行等应用会黑屏，正常现象
- 权限限制：部分应用禁止截图，Agent 会请求人工接管
-
模型连接失败
- 检查 API Key：确认 Key 有效且未过期
- 网络问题：确保 Termux 能访问外部网络
- Base URL：确认 URL 格式正确，结尾有
/v1
-
多设备环境下无法选择设备
- 使用
autoglm --devices查看所有设备 - 使用
autoglm --switch-device切换活动设备 - 或在配置中指定
PHONE_AGENT_DEVICE_ID="IP:端口"
- 使用
-
环境变量未生效
# 手动加载配置
source ~/.bashrc
# 或
source ~/.autoglm/config.sh-
卸载后 autoglm 命令仍可用
- 重新打开终端窗口
- 或手动执行
source ~/.bashrc重载配置 - 或手动执行
hash -r刷新命令缓存
-
更新失败
# 手动删除旧目录后重试
rm -rf ~/Open-AutoGLM
./deploy.sh-
语言切换问题
- 使用
autoglm --lang cn或autoglm --lang en切换语言 - 或在主菜单中选择"切换语言"选项
- 使用
-
语音识别功能无法使用
- 确保在部署时启用了语音识别功能
- 检查是否已安装 Termux:API 应用并授予麦克风权限
- 确认语音识别 API 配置正确
- 检查网络连接是否正常
-
已经安装了ADB Keyboard，但启动时ADB Keyboard报错
- 确保ADB Keyboard已经安装并启用
- 如果ADB无线调试配对了多台设备，在切换到其他设备启动时ADB Keyboard报错，可以尝试重启termux并重新连接，或进入ADB管理菜单内断开全部连接，并重启ADB，重新连接后再次启动AutoGLM
🔄 更新日志
v5.0.1 (当前版本)
- 新增：全面支持语音识别功能，可通过语音控制手机
- 新增：语音识别配置向导，支持多种语音识别服务
- 修复：语音识别和快速启动问题
- 优化：交互式菜单，支持动态显示语音功能选项
v4.6.0
- 新增：全面国际化支持，支持中英文界面切换
- 新增：语言选择向导，部署时即可选择语言
v4.5.0
- 增强 ADB 设备管理：支持设备列表查看、切换、断开、快速连接
- 新增一键卸载功能：提供基本卸载和完全卸载两种模式
- 改进多设备支持：可指定设备 ID，自动检测在线设备
- 优化交互体验：设备状态显示更清晰（在线/离线/未授权）
- 修复算术错误：修正设备计数问题
- 扩展命令行参数：新增
--devices,--switch-device,--disconnect,--uninstall - 增强兼容性：支持多种包管理器（apt、yum、pacman、brew）
v4.3.0
- 新增交互式启动面板
autoglm命令 - 支持无线 ADB 配对和连接向导
- 自动配置 pip 和 Cargo 国内镜像
- 支持多设备管理
v4.2.0
- 优化 Termux 兼容性
- 增加 ADB Keyboard 安装提醒
- 支持配置持久化
🤝 贡献指南
欢迎提交 Issue 和 Pull Request！
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
📄 许可证
本项目采用 MIT 许可证。详见 LICENSE 文件。
🔗 相关链接
- Open-AutoGLM 官方项目: https://github.com/zai-org/Open-AutoGLM
- Termux 官网: https://termux.dev/
- AutoGLM 论文: https://arxiv.org/abs/2411.00820
- 智谱 AI: https://www.zhipuai.cn/
- ModelScope: https://modelscope.cn/
- SiliconFlow（语音识别）: https://siliconflow.cn/
🙏 致谢
- Open-AutoGLM - 核心框架
- ADBKeyBoard - 输入解决方案
- Termux - 强大的终端模拟器
- Termux:API - 语音识别支持
💬 社区支持
遇到问题？需要帮助？
- 提交 Issue
- 查看 Open-AutoGLM 文档
- 加入 Open-AutoGLM 微信社区（见官方项目 README）
⭐ 如果这个项目对你有帮助，请点个 Star 支持一下！
📢 免责声明
本项目仅为 Open-AutoGLM 的自动化部署工具，所有核心功能由 Open-AutoGLM 提供。请确保遵守当地法律法规，合法使用本工具。开发者不对任何滥用行为承担责任。