AutoGLM-TERMUX

KO | EN

gitlite — search

#hacktoberfest #typescript #llm #go #golang #android #machine-learning #deep-learning #docker #macos #java #pytorch #security #open-source

(★ 197)

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!

AutoGLM-TERMUX 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

AutoGLM-Termux 部署工具

[![版本](https://img.shields.io/badge/版本-5.0.1-brightgreen)](https://github.com/eraycc/AutoGLM-TERMUX)
[![Open-AutoGLM](https://img.shields.io/badge/Open--AutoGLM-最新版-blue)](https://github.com/zai-org/Open-AutoGLM)
[![Termux](https://img.shields.io/badge/Termux-支持-black)](https://termux.dev/)
[![License](https://img.shields.io/badge/License-MIT-orange)](https://opensource.org/licenses/MIT)

[🌐 切换到英文文档 / Switch to English Documentation](https://github.com/eraycc/AutoGLM-TERMUX/blob/main/README_en.md)

在安卓手机上通过 Termux 快速部署 Open-AutoGLM 智能体，无需ROOT或电脑等其他设备，即可实现手机自动化操作！

---

📖 项目简介

AutoGLM-Termux 是一个专为 Termux 环境优化的 Open-AutoGLM 一键部署解决方案。它通过纯 ADB 方案，让你的安卓手机化身 AI 智能体，能够：
- 理解自然语言指令
- 自动执行手机操作（点击、滑动、输入等）
- 支持 50+ 款主流中文 App
- 增强 ADB 设备管理：支持多设备切换、快速连接、设备状态监控
- 一键卸载功能：完整卸载项目及运行环境
- 完全无线控制，无需 Root 或PC等其他设备
- 全面国际化支持，支持中英文切换
- 新增：**支持语音识别输入**，可通过语音控制手机

> ⚠️ 合规声明：本项目仅供学习和研究使用，严禁用于任何违法活动。请遵守 [Open-AutoGLM 使用条款](https://github.com/zai-org/Open-AutoGLM/blob/main/resources/privacy_policy.txt)。

---

✨ 功能特性

- 一键部署：自动化安装所有依赖和环境配置
- 智能镜像：自动配置国内 pip 和 Cargo 镜像源，加速下载（支持输入 `default` 使用推荐源）
- 无线 ADB：内置 ADB 无线调试配置向导，告别数据线
- 语音识别：支持语音输入指令，解放双手（需要安装 Termux:API）
- ADB 设备管理：可视化设备列表、切换活动设备、断开连接、快速重连
- 交互式菜单：可视化启动面板，管理配置更轻松
- 自动重连：支持 ADB 设备自动检测和连接
- 配置持久化：环境变量自动保存，重启 Termux 无需重新配置
- 多设备支持：同一局域网内，关闭VPN的情况下，可用安卓设备使用无线调试连接其他手机adb实现自动控制其他安卓手机设备，支持管理多个 ADB 设备
- 一键卸载：提供基本卸载和完全卸载两种模式，干净清理不残留
- 新增：多语言支持，可在中文和英文之间自由切换

---

🍭 部署演示

![1000114284](https://github.com/user-attachments/assets/d4e89a3c-8d39-41a8-a44e-bed00c74fdb0)

![1000114273](https://github.com/user-attachments/assets/3ca780ce-631c-4ae3-996a-8f3bf4eb4037)

![1000114283](https://github.com/user-attachments/assets/dd618ffc-4138-4bcf-bf0a-03562b364875)

---

📱 前置要求

1. 安卓手机（Android 11+）需支持无线调试
2. Termux 已安装（[下载地址](https://github.com/termux/termux-app/releases/)）
3. 网络连接：手机和 Termux 设备需在同一 WiFi 网络下
4. API Key：需要智谱 AI 或 ModelScope 的 API Key 或 其他支持图片识别的AI模型

5. 语音识别（可选）：如需语音控制功能，需安装 Termux:API 应用
   - 下载地址：https://github.com/termux/termux-api/releases/
   - 安装后，在 设置-应用管理 内或桌面长按 Termux:API 图标，进入应用权限管理界面，授予麦克风权限
   
   > 若无法安装上述Termux:API APK，可阅读官方文档：[Termux-microphone-record](https://wiki.termux.com/wiki/Termux-microphone-record) ， [Termux:API](https://wiki.termux.com/wiki/Termux:API)，在[f-droid](https://f-droid.org/packages/com.termux.api/)上尝试下载可用版本

6. 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 中执行以下命令，一键完成部署或更新：

```bash
# 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](https://github.com/termux/termux-app/releases/) 下载最新版 Termux APK 并安装。

步骤 2：更新 Termux

首次启动 Termux 后，执行：

```bash
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，等待自动配置完成即可

```bash
termux-change-repo
```

步骤 4：运行部署脚本

```bash
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](https://github.com/a251231)基于此一键部署项目独立维护，详细部署文档及issue反馈请查看：[AutoGLM-TERMUX-Web](https://github.com/a251231/AutoGLM-TERMUX/)

如果需要在局域网内用电脑/平板浏览器管理 AutoGLM（配置、启动/停止、看日志、ADB 配对/连接/切换/断开等），可选安装：

```bash
# 安装 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` 重置。

---

🎮 使用方法

启动控制面板

```bash
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. ↩️ 返回主菜单
```

命令行参数

```bash
# 直接启动交互模式（绕过菜单）
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
```

使用示例

```bash
# 示例 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`字典末尾添加：

```python
    # 自定义应用
    "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模型[暂时免费](https://docs.bigmodel.cn/cn/guide/models/vlm/autoglm-phone)）
   - Base URL: `https://open.bigmodel.cn/api/paas/v4`
   - 模型: `autoglm-phone`
   - 注册地址: [BigModel AFF 邀请](https://www.bigmodel.cn/claude-code?ic=COJZ8EMHXZ)
   - 密钥申请：[智谱 apikeys](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys)

2. ModelScope 魔搭社区
   - Base URL: `https://api-inference.modelscope.cn/v1`
   - 模型: `ZhipuAI/AutoGLM-Phone-9B`
   - 申请地址: [ModelScope 平台](https://modelscope.cn/)

3. 其他自定义 AI API 接入 AutoGLM
   - 支持 OpenAI 兼容格式的 API 接口
   - 需确保模型具备图像理解能力

4. 语音识别服务（可选）
   - 需要提供：openai 兼容格式的 AI 语音识别 API
   - 推荐平台：[硅基流动 AFF 邀请](https://cloud.siliconflow.cn/i/eQGNraUT)，注册即送 2000 万 Tokens
   - Base URL: `https://api.siliconflow.cn/v1`
   - 推荐模型：`FunAudioLLM/SenseVoiceSmall`（当前该模型免费）[siliconflow模型价格表](https://siliconflow.cn/pricing)
   - 密钥申请：[SiliconFlow apikey](https://cloud.siliconflow.cn/me/account/ak)
   
   > 语音识别也可以使用智谱 BigModel 提供的glm-asr-2512模型，详情可查看[官方文档](https://docs.bigmodel.cn/cn/guide/models/sound-and-video/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）
- ⚠️ 警告：可能影响依赖这些包的其他程序

执行方式：

```bash
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. 环境变量未生效

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

7. 卸载后 autoglm 命令仍可用
   - 重新打开终端窗口
   - 或手动执行 `source ~/.bashrc` 重载配置
   - 或手动执行 `hash -r` 刷新命令缓存

8. 更新失败

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

9. 语言切换问题
   - 使用 `autoglm --lang cn` 或 `autoglm --lang en` 切换语言
   - 或在主菜单中选择"切换语言"选项

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

11. 已经安装了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](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](https://github.com/zai-org/Open-AutoGLM) - 核心框架
- [ADBKeyBoard](https://github.com/senzhk/ADBKeyBoard) - 输入解决方案
- [Termux](https://termux.dev/) - 强大的终端模拟器
- [Termux:API](https://github.com/termux/termux-api) - 语音识别支持

---

💬 社区支持

遇到问题？需要帮助？

- 提交 [Issue](https://github.com/eraycc/AutoGLM-TERMUX/issues)
- 查看 [Open-AutoGLM 文档](https://github.com/zai-org/Open-AutoGLM/blob/main/README.md)
- 加入 Open-AutoGLM 微信社区（见官方项目 README）

---

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

---

📢 免责声明

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

AutoGLM-TERMUX

AutoGLM-TERMUX 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

AutoGLM-TERMUX

AutoGLM-TERMUX 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README