Skip to content

eraycc/AutoGLM-TERMUX

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
ADBKeyboard
ADBKeyboard
 
 
Old-Version
Old-Version
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
README_en.md
README_en.md
 
 
deploy.sh
deploy.sh
 
 

Repository files navigation

AutoGLM-Termux 部署工具

版本 Open-AutoGLM Termux License

🌐 切换到英文文档 / 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 设备
  • 一键卸载：提供基本卸载和完全卸载两种模式，干净清理不残留
  • 新增：多语言支持，可在中文和英文之间自由切换

🍭 部署演示

1000114284

1000114273

1000114283

📱 前置要求

  1. 安卓手机（Android 11+）需支持无线调试

  2. Termux 已安装（下载地址）

  3. 网络连接：手机和 Termux 设备需在同一 WiFi 网络下

  4. API Key：需要智谱 AI 或 ModelScope 的 API Key 或 其他支持图片识别的AI模型

  5. 语音识别（可选）：如需语音控制功能，需安装 Termux:API 应用

    若无法安装上述Termux:API APK，可阅读官方文档：Termux-microphone-record ， Termux:API，在f-droid上尝试下载可用版本

  6. 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：脚本执行流程

脚本将自动完成以下操作：

  1. 语言选择：首次运行时会提示选择中文或英文界面
  2. 安装依赖：Python、pip、Git、Rust、ADB（支持自动检测多种包管理器）
  3. 配置镜像源：可选配置国内 pip/Cargo 镜像加速（输入 default 使用推荐源）
  4. 安装 Python 包：maturin、openai、requests、Pillow（Termux 环境通过 pkg 安装 Pillow）
  5. 克隆项目：从 GitHub 拉取 Open-AutoGLM 最新代码
  6. 语音识别配置：可选择是否启用语音控制功能
  7. 交互式配置：设置 API Key、模型参数等（新增设备 ID 配置）
  8. ADB Keyboard 提醒：提示安装必需的输入法工具（必须步骤）
  9. ADB 无线配置：引导完成手机无线调试连接（支持自动检测已连接设备）
  10. 创建启动器：生成 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支持一键打开更多应用。

准备工作

  1. 下载并安装MT管理器 下载链接：https://mt2.cn/download/

配置步骤

步骤1：授予MT管理器Termux文件访问权限

  1. 打开MT管理器，展开侧边栏
  2. 点击顶部"三个点"更多按钮，选择"添加本地存储"
  3. 在新界面中再次点击左上角"三个点"，打开侧边栏
  4. 找到并选择"Termux"（显示可用空间：xx GB）
  5. 点击"使用此文件夹"授权

步骤2：修改应用配置文件

  1. 返回MT管理器首页，在侧边栏中找到"Termux Home"
  2. 进入目录：Open-AutoGLM/phone_agent/config/
  3. 打开apps.py文件
  4. 定位到APP_PACKAGES配置字典
  5. 在字典末尾添加你的自定义应用，格式："应用名称": "应用包名"

示例配置 在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模型需要图像识别能力）

  1. 智谱 BigModel（推荐，目前官方autoglm-phone模型暂时免费）

  2. ModelScope 魔搭社区

    • Base URL: https://api-inference.modelscope.cn/v1
    • 模型: ZhipuAI/AutoGLM-Phone-9B
    • 申请地址: ModelScope 平台

  3. 其他自定义 AI API 接入 AutoGLM

    • 支持 OpenAI 兼容格式的 API 接口
    • 需确保模型具备图像理解能力

  4. 语音识别服务（可选）

    语音识别也可以使用智谱 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

进入交互式卸载菜单，按需选择即可。

⚠️ 常见问题与故障排除

  1. adb devices 不显示设备或显示未授权

    • 检查 USB 调试：开发者选项中必须开启 USB 调试 和 无线调试
    • 检查网络：确保手机和 Termux 在同一 WiFi 网络
    • 授权弹窗：手机上点击 "允许 USB 调试"
    • 重新配对：删除旧配对，重新执行 adb pair
    • 重启 ADB：执行 adb kill-server && adb start-server

  2. 能打开应用但无法点击或输入

    • 开启安全调试：部分手机需要开启 "USB 调试（安全设置）"
    • 必须安装 ADB Keyboard：设置 → 语言和输入法 → 启用 ADB Keyboard
    • 切换输入法：运行时需切换到 ADB Keyboard（Agent 会自动切换）

  3. 截图黑屏

    • 敏感页面：支付、银行等应用会黑屏，正常现象
    • 权限限制：部分应用禁止截图，Agent 会请求人工接管

  4. 模型连接失败

    • 检查 API Key：确认 Key 有效且未过期
    • 网络问题：确保 Termux 能访问外部网络
    • Base URL：确认 URL 格式正确，结尾有 /v1

  5. 多设备环境下无法选择设备

    • 使用 autoglm --devices 查看所有设备
    • 使用 autoglm --switch-device 切换活动设备
    • 或在配置中指定 PHONE_AGENT_DEVICE_ID="IP:端口"

  6. 环境变量未生效

   # 手动加载配置
   source ~/.bashrc
   # 或
   source ~/.autoglm/config.sh

  1. 卸载后 autoglm 命令仍可用

    • 重新打开终端窗口
    • 或手动执行 source ~/.bashrc 重载配置
    • 或手动执行 hash -r 刷新命令缓存

  2. 更新失败

   # 手动删除旧目录后重试
   rm -rf ~/Open-AutoGLM
   ./deploy.sh

  1. 语言切换问题

    • 使用 autoglm --lang cn 或 autoglm --lang en 切换语言
    • 或在主菜单中选择"切换语言"选项

  2. 语音识别功能无法使用

    • 确保在部署时启用了语音识别功能
    • 检查是否已安装 Termux:API 应用并授予麦克风权限
    • 确认语音识别 API 配置正确
    • 检查网络连接是否正常

  3. 已经安装了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！

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

🔗 相关链接

🙏 致谢

💬 社区支持

遇到问题？需要帮助？

⭐ 如果这个项目对你有帮助，请点个 Star 支持一下！

📢 免责声明

本项目仅为 Open-AutoGLM 的自动化部署工具，所有核心功能由 Open-AutoGLM 提供。请确保遵守当地法律法规，合法使用本工具。开发者不对任何滥用行为承担责任。

About

Quickly deploy Open-AutoGLM agent on Android phone using Termux. Support AI voice recognition and enable automated operation of your phone without Root or PC!

Resources

Readme

License

MIT license
Activity

Stars

170 stars

Watchers

2 watching

Forks

35 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages