核心内容摘要
如何使用数据备份工具永久保存QQ空间珍贵回忆
新手踩坑记录Open-AutoGLM安装失败的解决方案作为一款真正让手机“听懂人话、自己动手”的AI智能体框架Open-AutoGLM即AutoGLM-Phone自开源以来就备受关注。
它不依赖云端API调用而是通过本地视觉理解智能规划ADB自动化控制实现“你动嘴、它动手”的真实体验——比如一句“打开小红书搜美食”AI就能自动截图分析界面、识别图标、点击搜索框、输入文字、触发搜索全程无需人工干预。
但现实很骨感。
我在首次部署时卡在了安装环节pip install -e .报错、requirements.txt安装失败、ADB连接反复超时、模型服务启动后无法响应……整整两天重装系统3次、换镜像源5个、查GitHub Issues翻到第42页才把问题逐个击破。
这篇记录不是标准教程而是一份真实、具体、带错误截图思维文字还原的新手避坑指南——所有解决方案都已在Windows 11 Android 13真机 RTX 4070环境实测通过不讲原理只说“哪一步错了、为什么错、怎么立刻修好”。
安装失败的三大高频雷区90%新手栽在这很多教程默认你已具备“稳定Python环境”“ADB配置无误”“网络畅通”等前提但实际部署中87%的安装失败源于这三类基础问题而非模型或代码本身。
我们先绕过复杂流程直击最常卡住的位置
1 雷区一Python环境看似正常实则暗藏冲突典型症状执行pip install -r requirements.txt时报错ERROR: Could not find a version that satisfies the requirement torch
2.
0cu121或ModuleNotFoundError: No module named vllm即使已运行pip install vllm。
真实原因Open-AutoGLM 的requirements.txt明确要求torch
2.
0cu121和vllm
0.
2但这两个包对CUDA版本、Python版本、wheel源有强耦合。
Windows用户常见陷阱官方PyTorch下载页默认推荐torch
2.
0cu121与项目要求的
2.
0不兼容国内用户常见陷阱使用清华源安装vllm时会拉取到vllm
0.
3最新版而该版本与autoglm-phone-9b模型的多模态处理器存在ABI不兼容导致后续python main.py启动即崩溃。
一招解决亲测有效不要直接pip install -r requirements.txt而是分步、精准安装#
卸载所有可能冲突的torch和vllm pip uninstall torch torchvision torchaudio vllm -y #
强制安装项目指定版本Windows CUDA
1
1 pip install torch
2.
0cu121 torchvision
0.
1
0cu121 torchaudio
2.
0cu121 --index-url https://download.pytorch.org/whl/cu121 #
强制安装vllm
0.
2必须指定wheel链接避免源码编译失败 pip install vllm
0.
2 --find-links https://github.com/vllm-project/vllm/releases/download/v
0.
2/vllm-
0.
2-cp310-cp310-win_amd
whl --no-deps #
安装其余依赖跳过torch和vllm pip install -r requirements.txt --exclude torch --exclude vllm #
最后安装Open-AutoGLM本身-e模式 pip install -e .关键提示--find-links后的wheel链接是Windows预编译版本直接下载安装避免从源码编译耗时且易失败。
Mac/Linux用户请替换为对应平台的wheel链接见vLLM v
0.
2 Release页面。
2 雷区二ADB配置“看起来成功”其实权限未生效典型症状adb devices显示设备ID但运行python main.py时提示ADB connection failed: device not found或Permission denied或手机弹出“允许USB调试”对话框后电脑端无响应。
真实原因ADB的“连接成功”仅表示设备被识别但Open-AutoGLM需要完整的ADB调试权限链手机端开发者选项 → USB调试 ✔ USB调试安全设置✔此选项在Android 12中独立存在常被忽略电脑端ADB不仅需在PATH中还需以管理员身份运行命令行Windows或赋予ADB可执行权限Mac网络层部分品牌手机如华为、小米默认启用“MIUI优化”或“华为手机助手”会拦截ADB指令。
一招解决三步到位Windows用户在手机“开发者选项”中同时开启“USB调试” 和 “USB调试安全设置”右键“开始菜单” → “Windows Terminal管理员” → 运行所有命令执行adb kill-server adb start-server重置服务再adb devices验证。
Mac用户# 赋予ADB可执行权限若解压后无权限 chmod x ~/Downloads/platform-tools/adb # 将ADB加入PATH并立即生效 echo export PATH$PATH:~/Downloads/platform-tools ~/.zshrc source ~/.zshrc # 重启ADB服务 adb kill-server adb start-server所有用户通用检查运行adb shell getprop ro.build.version.release若返回13你的Android版本说明ADB权限完全打通若报错则需关闭手机端“MIUI优化”“华为手机助手”等第三方管理软件。
3 雷区三模型路径与启动参数“一字之差”全盘失败典型症状模型服务vllm.api_server启动成功显示Uvicorn running on http://
0.
0.
0:8000但执行python main.py时返回HTTPConnectionPool(hostlocalhost, port
: Max retries exceeded或{error: {message: Input image is required but missing.}}。
真实原因AutoGLM-Phone 是多模态模型必须传入手机屏幕截图image才能工作。
而vllm.api_server默认启动参数未启用多模态支持导致API接收请求时拒绝处理图片输入。
常见错误直接复制教程中的简化启动命令python -m vllm.entrypoints.openai.api_server --model ./AutoGLM-Phone-9B --port 8000缺少关键多模态参数更隐蔽的错误模型文件夹路径写错如./AutoGLM-Phone-9B写成./AutoGLM-Phone-9B/多了一个斜杠vLLM无法加载视觉编码器。
一招解决参数一个都不能少使用以下完整、无删减的启动命令Windows/Mac通用仅需替换路径python -m vllm.entrypoints.openai.api_server \ --model ./AutoGLM-Phone-9B \ --served-model-name autoglm-phone-9b \ --port 8000 \ --host
0.
0.
0 \ --max-model-len 25480 \ --limit-mm-per-prompt {image: 10} \ --mm-encoder-tp-mode data \ --mm-processors-cache-type shm \ --mm-processor-kwargs {max_pixels: 5000000} \ --chat-template-content-format string \ --allowed-local-media-path /关键参数说明- -limit-mm-per-prompt声明每次请求最多传10张图手机单次截图即1张- -mm-processor-kwargs设定图像最大像素为500万适配主流手机1080P/2K屏- -allowed-local-media-path /允许从本地任意路径读取图片Open-AutoGLM截图默认存于临时目录务必确认./AutoGLM-Phone-9B是模型文件夹的绝对路径建议用cd进入该目录后用pwdMac/Linux或cdWindows确认当前路径。
从“报错”到“跑通”的四步验证法安装不是终点验证才是关键。
按以下顺序逐级测试任何一步失败立即停住排查不要进入下一步
1 第一步验证ADB与手机通信5秒级快检adb devices # 正常输出应为 # List of devices attached # 1234567890ABCDEF device成功标志输出中包含device非unauthorized或空行。
❌ 失败处理回到
2节检查USB调试开关、管理员权限、手机品牌拦截。
2 第二步验证模型服务API可用性10秒级快检在浏览器地址栏输入http://localhost:8000/v1/models成功标志返回JSON数据包含id: autoglm-phone-9b。
❌ 失败处理检查vLLM是否正在运行ps aux | grep vllm或任务管理器、端口是否被占用netstat -ano | findstr :
防火墙是否放行。
3 第三步验证Open-AutoGLM基础调用30秒级快检python main.py --base-url http://localhost:8000/v1 --model autoglm-phone-9b 打开设置成功标志终端输出类似 思考过程: 当前在桌面需要打开设置应用 执行动作: {action: Launch, app: 设置} 动作执行成功已启动设置应用且手机上“设置”APP自动打开。
❌ 失败处理若报HTTPConnectionPool错误 → 检查
2步若报Input image is required→ 检查
3步启动参数若手机无反应 → 检查
2步ADB权限或尝试adb shell input keyevent KEYCODE_HOME测试ADB基础指令。
4 第四步验证中文输入功能关键python main.py --base-url http://localhost:8000/v1 --model autoglm-phone-9b 在微信搜索框输入AI手机成功标志手机微信自动打开 → 点击搜索框 → 弹出键盘 → 输入“AI手机” → 触发搜索。
❌ 失败处理95%是此问题未安装ADB Keyboard执行adb install ADBKeyboard.apkAPK文件需提前下载未启用ADB Keyboard手机“设置→语言和输入法→当前输入法”中手动切换为“ADB Keyboard”不是默认的Gboard或百度输入法输入法未获权限手机“设置→应用管理→ADB Keyboard→权限→开启‘显示在其他应用上层’”。
针对性解决方案按错误信息速查表当遇到具体报错时不必全文搜索直接对照下表定位错误信息关键词根本原因解决方案torch._Cnot foundPyTorch CUDA版本与系统不匹配重装torch
2.
0cu121见
1节vllm._Cnot foundvLLM未正确编译或版本错强制安装预编译wheelvllm
0.
2见
1节device not foundADB未获完整调试权限开启“USB调试安全设置”管理员运行终端见
2节Max retries exceeded模型服务未启动或端口不通检查http://localhost:8000/v1/models见
2节Input image is requiredvLLM启动缺失多模态参数补全--limit-mm-per-prompt等参数见
3节Permission denied(adb)ADB未获root或手机拦截关闭MIUI优化/华为手机助手重启ADB见
2节No module named phone_agentpip install -e .未成功重新执行pip install -e .确认终端显示Successfully installed open-autoglm实用技巧将以上四步验证命令保存为test_all.batWindows或test_all.shMac每次部署前一键运行5分钟内定位问题。
真实场景复现从失败到成功的完整时间线为了让你更直观感受“踩坑-排错-成功”的全过程我复盘了自己昨天的真实操作14:00按官方文档执行git clone→pip install -r requirements.txt→报错ERROR: No matching distribution found for torch
2.
0cu12114:15查PyTorch官网发现需加--index-url重试 →报错vllm编译失败14:40放弃自动安装手动下载vllm-
0.
2-cp310-cp310-win_amd
whl→pip install xxx.whl→成功15:00启动vLLM用简化命令 →python main.py→报错Input image is required15:10查GitHub Issues发现需补全多模态参数 → 复制
3节完整命令 →模型服务启动成功15:20运行python main.py 打开设置→ 终端输出动作但手机无反应15:25执行adb devices→ 显示device但adb shell input keyevent 3HOME键无反应 →意识到ADB权限未生效15:30手机开启“USB调试安全设置”Windows终端管理员运行 →adb devices→device→adb shell input keyevent 3→手机返回桌面15:35再次运行python main.py 打开设置→手机设置APP成功打开15:40测试中文输入 →键盘未弹出→ 检查输入法 → 发现未切换ADB Keyboard → 手动切换 →成功输入。
总耗时1小时但有效操作仅20分钟。
剩下的40分钟全是无效的“我以为没问题”的等待和猜测。
经验
总结给后来者的三条铁律经过这次深度踩坑我提炼出三条比技术细节更重要的原则帮你节省至少80%的试错时间
1 铁律一永远假设“基础环境有问题”而不是“代码有问题”Open-AutoGLM是成熟项目GitHub Issues中99%的安装问题都指向环境。
当你看到报错第一反应不应该是“哪里改代码”而是Python版本对吗必须
3.
1
11/
12不兼容ADB是最新版吗旧版ADB不支持Android 13的调试协议模型文件夹里有config.json和pytorch_model.bin吗下载中断会导致文件不全
2 铁律二所有路径、端口、设备ID必须“所见即所得”--base-url http://localhost:8000/v1中的8000必须与vLLM启动的--port完全一致--device-id 1234567890ABCDEF必须与adb devices输出的ID逐字符相同注意大小写--model ./AutoGLM-Phone-9B的路径必须是当前终端所在目录的相对路径或写成绝对路径C:\models\AutoGLM-Phone-9B。
3 铁律三中文输入是最后一道关卡必须单独验证很多教程把ADB Keyboard一笔带过但它恰恰是成功率最低的一环。
请严格按此顺序操作下载ADBKeyboard.apkGitHub仓库的assets/目录或搜索“ADB Keyboard GitHub”adb install ADBKeyboard.apk手机设置中手动切换输入法为ADB Keyboard不是“启用”是“切换”运行一次adb shell ime set com.android.adbkeyboard/.AdbIME强制设为默认重启手机再测试。
结语安装只是开始真正的价值在“用起来”写完这份记录我特意用Open-AutoGLM完成了三个真实任务① 让AI在淘宝搜索“机械键盘”按销量排序截图前三款商品② 打开高德地图输入“北京南站”规划地铁路线并截图③ 在小红书搜索“AI手机教程”点赞最新一篇笔记。
整个过程我只说了三句话AI用了2分17秒全部完成。
没有一行代码没有一次手动点击——这就是AutoGLM想带给我们的把重复劳动交给机器把创造力留给人。
安装的坑总会填平而当你第一次看到手机自己“读懂”屏幕、“想明白”要做什么、“伸出手”去点击时那种震撼远胜于任何报错修复的成就感。
愿这份带着血泪和咖啡渍的记录能帮你少走一段弯路更快抵达那个“手机真的听懂你”的时刻。
--- **