PC环境：
版本 Windows 10 专业版
版本号 20H2
Python 环境
建议使用 Python 3.10 及以上版本。
1.下载Python 3.10以上版本:访问python.org
windows版本下载地址：https://www.python.org/downloads/windows/
3.13.8 64位下载地址：https://www.python.org/ftp/python/3.13.8/python-3.13.8-amd64.exe
第三方Python详细安装教程：https://www.jb51.net/python/337525fsg.htm
图片展示的是Python 3.13.8在Windows上的下载页面。页面中列出了不同版本的下载选项，包括Windows installer (64-bit)、Windows installer (32-bit)、Windows embeddable package (64-bit)等。其中，3.13.8版本的Windows installer (64-bit)被红色箭头指向突出显示。该图片与文档中Python环境搭建部分的下载Python 3.10以上版本内容相关，直观呈现了下载页面及3.13.8版本的下载位置。
2.安装时勾选"Add Python to PATH'，这两项都勾选
安装的时候右键点击下载好的exe安装包，然后用管理员身份进行安装。要不然有的会报错。
图片展示了在Windows上安装Python 3.13.8（64-bit）时的安装界面。界面中有“Install Now”和“Customize installation”两个选项，当前选中“Install Now”。下方有勾选框，分别用于“Use admin privileges when installing py.exe”和“Add python.exe to PATH”，其中“Add python.exe to PATH”被红色箭头突出指向。该图片与文档中Python环境搭建部分相关，用于说明在安装Python时需勾选“Add python.exe to PATH”以配置环境变量。
图片展示的是Python 3.13.8 (64-bit)安装界面中的“Advanced Options”选项卡。画面中有一个红色箭头指向“Install Python 3.13 for all users”选项，提示用户勾选全部用户。此外，还有“Associate files with Python (requires the 'py' launcher)”“Create shortcuts for installed applications”“Add Python to environment variables”等选项，以及“Customize install location”区域，可设置安装位置。该图片与文档中Python环境搭建部分相关，用于指导用户在安装Python时进行相关设置。
3.验证安装:按 win+R输入cmd，执行python --version
图片展示了在Windows系统cmd命令行中验证Python环境安装情况的界面。首先输入“python -V”，显示Python版本为3.13.8；接着输入“python --version”，再次确认Python版本为3.13.8。该图片与文档中“Python环境”部分的验证安装步骤对应，通过执行命令查看Python版本，以确保Python环境已正确安装。
ADB (Android Debug Bridge) - 必选
ADB是连接手机和电脑的桥梁，用于发送控制指令。
下载官方 ADB 安装包 ，并解压到自定义路径，比如：F:\adb-platform-tools
下载适合自己系统的platform-tools
图片展示了Windows系统下ADB平台工具的文件夹内容。文件夹内有多个文件，如adb.exe、AdbWinApi.dll等，其中adb.exe文件大小为6,487 KB，AdbWinApi.dll文件大小为106 KB，AdbWinUsbApi.dll文件大小为72 KB，etc1tool.exe文件大小为444 KB，fastboot.exe文件大小为2,003 KB等。该图片与文档中“Python环境”部分的ADB环境搭建内容相关，直观呈现了ADB平台工具的文件结构及部分文件信息。
配置环境变量
Windows 配置方法：可参考 第三方教程 进行配置。
按键 windows+r 打开运行，输入回车 sysdm.cpl。
图片展示了Windows系统中“运行”窗口界面。窗口标题为“运行”，提示Windows将根据输入名称打开相应程序等。下方有“打开”下拉框，当前显示“sysdm.cpl”。窗口底部有三个按钮，分别是蓝色的“确定”按钮、灰色的“取消”按钮以及灰色的“浏览”按钮。该图片对应文档中“Windows配置方法”部分，用于说明在Windows系统中打开“运行”窗口的操作步骤，是配置环境变量前的操作步骤之一。
图片展示的是Windows系统中“系统属性”窗口的“系统保护”选项卡。窗口中显示了计算机描述、计算机全名、工作组等信息，其中“计算机全名”为PC - 20230917QJBM，“工作组”为WorkGroup。窗口右下角有“确定”“取消”“应用”按钮。该图片与文档中Windows环境配置相关，用于说明在Windows系统中查看系统属性的操作界面，是配置环境变量前的系统信息展示。
图片展示了Windows系统中“系统属性”窗口，用于配置环境变量。窗口中有“计算机名”“硬件”“高级”“系统保护”“远程”等标签，当前选中“高级”标签。在“高级”标签下，有“性能”“用户配置文件”“启动和故障恢复”等设置项，其中“环境变量”按钮被红色箭头突出显示。该图片与文档中“配置环境变量”部分内容相关，指导用户在Windows系统中点击“高级”标签后，再打开“环境变量”以进行后续配置操作。
图片展示的是Windows系统中“环境变量”设置界面。界面分为“用户变量”和“系统变量”两部分，其中“用户变量”下“Path”变量值为C:\Users\Administrator\AppData\Local\Microsoft\WindowsApps等路径。图片上有红色箭头指向“Path”变量，并标注“3.双击 Path”，提示用户在配置环境变量时，需双击“Path”进行相关操作。该图片与文档中“配置环境变量”部分内容相关，用于指导用户在Windows系统中配置环境变量时的操作步骤。
图片展示的是Windows系统中配置环境变量时的“编辑环境变量”窗口。窗口中有一个文本框，提示“5.点击新建，输入文件夹路径”，并有红色箭头指向“新建”按钮。该图片与文档中“Python环境”配置部分相关，用于指导用户在配置环境变量时，点击“新建”按钮后，输入文件夹路径以完成环境变量的配置操作，确保Python环境在Windows系统上正确安装和运行。
图片展示的是Windows系统中配置环境变量时的“编辑环境变量”窗口。窗口中显示了“%USERPROFILE%\AppData\Local\Microsoft\WindowsApps F:\adb - platform - tools”路径，右侧有“新建”“编辑”“浏览”“删除”“上移”“下移”“编辑文本”等操作按钮。图片下方有红色箭头指向“确定”按钮，并标注“6.点击确定”，指导用户完成环境变量配置后点击该按钮。
两次确认后重新打开命令行，查看是否安装成功。
输入：adb --version
显示出版本信息就表示成功了。
图片展示的是在Windows系统下配置环境变量后，使用命令行查看adb版本信息的界面。界面显示“Microsoft Windows [版本 10.0.19042.630]”等信息，输入“adb --version”后，返回了Android Debug Bridge的相关版本信息，包括版本号、安装路径及运行系统等，如“Version 1.0.41”等，最后提示“Running on Windows 10.0.19042”。该图片与文档中Python环境配置部分相关，用于验证adb是否安装成功。
Android 7.0+ 的设备或模拟器，并启用 开发者模式 和 USB 调试
开发者模式启用：通常启用方法是，找到 设置-关于手机-版本号 然后连续快速点击 10 次左右，直到弹出弹窗显示“开发者模式已启用”。不同手机会有些许差别，如果找不到，可以上网搜索一下教程。
USB 调试启用：启用开发者模式之后，会出现 设置-开发者选项-USB 调试，勾选启用
部分机型在设置开发者选项以后, 可能需要重启设备才能生效. 可以测试一下: 将手机用USB数据线连接到电脑后, adb devices 查看是否有设备信息, 如果没有说明连接失败.
请务必仔细检查相关权限
图片展示了安卓设备的“开发者选项”中“调试”部分设置界面。其中，“USB调试”开关处于开启状态；“撤消USB调试授权”和“无线调试”开关处于关闭状态；“USB安装”和“USB调试（安全设置）”开关也处于开启状态。该图片与文档中“USB调试启用”步骤相关，直观呈现了USB调试开启后的设置情况，帮助用户确认是否已正确开启USB调试功能。
安装 ADB Keyboard(用于文本输入)
下载 安装包 并在对应的安卓设备中进行安装。 注意，安装完成后还需要到 设置-输入法 或者 设置-键盘列表 中启用 ADB Keyboard 才能生效(或使用命令adb shell ime enable com.android.adbkeyboard/.AdbIMEHow-to-use )
下载git，然后安装git (如果是下载的zip，这里可以不用安装git)
地址：https://git-scm.com/install/windows
图片展示的是git官网的安装页面。页面左侧有“Install”选项，右侧是安装指南。页面上方有“Install”标签，下方有“Windows”“macOS”“Linux”“Build from Source”选项卡，当前选中“Windows”。关键信息是“Click here to download the latest (2.32.0) x64 version of Git for Windows”处，有红色箭头指向，提示点击下载win版本。该图片与文档中下载git并安装git（Windows版本）的内容相关，指导用户下载git安装。
安装git选择默认即可，可以参考安装git的详细教程：https://cloud.tencent.com/developer/article/1450659
AutoGLM支持的应用
Phone Agent 支持 50+ 款主流中文应用：
运行 python main.py --list-apps 查看完整列表。
在开始部署前，请逐项向用户确认以下内容：
硬件环境
用户有一台安卓手机(Android 7.0+)
用户有一根支持数据传输的 USB 数据线(不是仅充电线)
手机和电脑可以通过数据线连接
手机端配置
手机已开启「开发者模式」(设置 → 关于手机 → 连续点击版本号 7 次)
手机已开启「USB 调试」(设置 → 开发者选项 → USB 调试)
部分机型需要同时开启「USB 调试(安全设置)」
手机已安装 ADB Keyboard 应用(下载地址：https://github.com/senzhk/ADBKeyBoard/blob/master/ADBKeyboard.apk )
ADB Keyboard 已在系统设置中启用(设置 → 语言和输入法 → 启用 ADB Keyboard)
下面为华为手机截图，其他机型请百度。
（一）、直接使用第三方API，比如这里用的是modelscope
下载所需框架
智谱官方Github开源项目地址：
https://github.com/zai-org/Open-AutoGLM/tree/main
图片展示的是Open-AutoGLM官方GitHub仓库页面。页面左侧为仓库目录，包含github、examples、phone_agent等文件夹。右侧是仓库介绍，有About、Files、Code、Issues、Pull requests等选项。关键信息是页面右上角“Code”按钮旁的下拉菜单，其中“Download ZIP”选项被红色箭头突出显示，提示可直接下载压缩包，与文档中“通过链接直接下载压缩包”及“使用git clone命令将仓库克隆到本地”两种下载方式相呼应。
或者(二选一即可)：
git clone https://github.com/zai-org/Open-AutoGLM.git
解压后的文件如下所示：
图片展示了Open-AutoGLM - main文件夹下的内容。文件夹内有多个文件夹和文件，如.gitignore、LICENSE、README.md等，其中“phone_agent”文件夹被红框突出显示。该图片与文档中“创建虚拟环境”步骤相关，用于说明在下载解压后的文件后，会在当前目录下创建一个名为“phone-agent”的文件夹，该文件夹包含独立的Python解释器和pip，是创建虚拟环境的产物。
安装Agent
先创建一个文件夹，比如我这里的（你可以根据需求自己创建一个文件夹）：F:\work\autoglm1
图片展示了在Windows系统下使用命令行操作的界面。首先显示了Windows版本信息，接着输入“python --version”命令，显示Python 3.13.8版本。然后将目录切换到F:\work\autoglm1文件夹，执行“adb devices”命令，提示daemon未运行，正在启动，成功启动后列出设备连接列表。该图片与文档中“创建虚拟环境”步骤相关，展示了在命令行中进行相关操作的示例。
创建虚拟环境
python -m venv phone-agent
图片展示了在Windows系统下创建虚拟环境的操作界面。首先，命令行窗口显示当前目录为C:\Windows\system32。接着，输入“cd F:\work\autoglm”切换到指定文件夹，再输入“f:”切换磁盘，最后执行“python -m venv phone-agent”命令创建名为“phone-agent”的虚拟环境。该图片与文档中“创建虚拟环境”部分内容对应，直观呈现了创建虚拟环境的操作步骤。
这会在当前目录下创建一个名为 phone-agent 的文件夹，里面包含独立的 Python 解释器和 pip。
图片展示了在F盘work文件夹下的autoglm1文件夹内容。其中，phone-agent文件夹被选中，显示其类型为文件夹，修改日期为2025年12月15日9:51。该图片与文档中“创建虚拟环境”步骤相关，对应于在当前目录下创建一个名为phone-agent的文件夹，里面包含独立的Python解释器和pip，是后续安装依赖的基础环境准备。
激活虚拟环境
Windows (CMD/PowerShell):
phone-agent\Scripts\activate
图片展示了Windows环境下激活虚拟环境后的界面。画面中显示了F盘下的work文件夹中的autoglm1文件夹，其中包含多个文件和文件夹，如activate、activate.bat等。红色箭头指向“activate.bat”文件，旁边有红色框标注“在这个目录中激活虚拟环境”，表明在该目录下激活虚拟环境的操作。此图与文档中“激活虚拟环境”步骤相关，直观呈现了激活后的文件目录情况。
macOS / Linux:
source phone-agent/bin/activate
CMD中输入上面的激活代码，这里用windows激活后的界面
图片展示了Windows系统CMD界面，显示当前目录为F:\work\autoglm1。界面上方有“C:\Windows\system32\cmd.exe”字样，表明当前操作环境。该图片与文档中“激活虚拟环境”步骤相关，是在CMD中输入激活代码后显示的界面，用于确认虚拟环境已成功激活，处于“phone-agent”环境，为后续安装依赖等操作做好准备。
开始安装依赖
把解压后的文件内容都复制到F:\work\autoglm1\phone-agent中
图片展示了在Windows系统中将Open-AutoGLM-main文件夹复制到phone-agent文件夹时出现的“替换或跳过文件”窗口。窗口中显示正在将54个项目从Open-AutoGLM-main复制到phone-agent，且目标已包含一个名为.gitignore的文件。窗口中有两个选项，分别是“替换目标中的文件”和“跳过该文件”，其中“替换目标中的文件”被红色箭头指向突出显示。该图片与文档中“开始安装依赖”步骤相关，用于说明在复制文件夹内容时的操作选择。
使用国内的源。
pip install -r requirements.txt -i https://mirrors.ustc.edu.cn/pypi/simple
图片展示的是在Windows系统CMD命令行中，使用国内源安装AutoGLM依赖的过程。命令行窗口显示“pip install -r requirements.txt -i https://mirrors.ustc.edu.cn/pypi/simple”命令执行情况，可见正在从指定镜像源查找和下载多个依赖包，如openai、typing_extensions等，显示了每个包的下载进度、大小等信息。此图与文档中“开始安装依赖”部分上下文对应，呈现了安装依赖时命令行的实际运行状态。
图片展示的是在Windows系统中使用CMD执行pip安装命令的界面。界面中显示了pip安装过程，包括下载、安装多个依赖包等信息。关键部分是红色箭头指向处，提示“pip 25.2 is available. To update, run: python.exe -m pip install --upgrade pip”，表明pip 25.2版本可用，需运行此命令升级pip。下方箭头指向处显示“Successfully installed pip-25.3”，表明pip已成功升级到25.3版本。该图片与文档中“开始安装依赖”步骤相关，用于指导用户升级pip。
然后升级一下pip
python.exe -m pip install --upgrade -i https://mirrors.ustc.edu.cn/pypi/simple
pip install -e .
图片展示了在Windows系统中使用CMD命令安装AutoGLM依赖的界面。命令为“python.exe -m pip install --upgrade pip”，并执行了“pip install -e .”操作。界面中显示了pip的下载和安装进度，如“pip-25.3-py3-none-any.whl”下载进度为47.8 KB/s，安装进度为1.8/1.8 MB。图片下方有红色箭头指向“pip install -e .”命令，旁边文字提示“注意后面的.号不能遗漏”，与上下文介绍的安装依赖步骤相关，强调该命令的正确书写方式。
图片展示了在Windows系统中使用CMD命令安装AutoGLM相关依赖的命令行界面。界面中显示了pip install -e .命令的执行过程，包括获取依赖、安装依赖等步骤，最终提示“Requirement already satisfied”等信息，表明安装成功。该图片与文档中“开始安装依赖”部分对应，直观呈现了安装操作及结果，帮助用户确认安装是否成功。
安装成功如下所示，如果失败了，请重试改命令。
图片展示的是在Windows系统下使用cmd命令行界面执行相关命令后的输出结果。命令执行后，显示了多个Requirement已满足的提示信息，如pydantic-core、typing-inspection、colorama等。接着，成功构建了phone - agent的可编辑版本，并将其安装到指定目录，最后显示“Successfully built phone - agent”和“Successfully installed phone - agent - 0.1.0”等成功信息。该图片与文档中“实现思路（第三方API+自行部署）”部分相关，用于说明安装成功情况。
使用第三方模型服务
我这里使用的是modelscope的API，下面是获取api key的地址。（需要注册，每天可获得免费推理API次数）
https://www.modelscope.cn/my/myaccesstoken
图片展示的是ModelScope平台的个人中心界面。左侧为导航栏，有我的任务、我的模型等选项。右侧显示访问令牌和Git访问令牌，其中Git访问令牌已过期。右侧还列出个人主页、模型类型、数据集等信息。图片右侧有红色箭头指向“账号设置”选项，旁边有文字提示“需要绑定阿里云账号这样可以获得免费的资源”。该图片与文档中使用第三方模型服务的内容相关，说明了在ModelScope平台获取免费资源的操作步骤。
当然你也可以使用智谱官方的API：（具体可以查看官网github上面的文档）
python main.py --base-url https://open.bigmodel.cn/api/paas/v4 --model "autoglm-phone" --apikey "your-bigmodel-api-key" "打开美团搜索附近的火锅店"
开始测试之前请确保安卓手机已经安装了ADBKeyboard.apk（并且在输入法中勾选启用），以及打开了开发者模式并且开启了usb调试。
如果没有问题后，可以在cmd中输入adb devices就可以查看已经连接的设备。
图片展示的是在Windows系统下使用adb命令查询设备连接状态的命令行界面。界面中输入了“adb devices”命令，执行后显示“List of devices attached”及设备信息，其中设备编号为“Q2NVB20728035342”，其后有“device”标识，表明该设备已连接。该图片与文档中使用第三方模型服务的内容相关，用于说明在Windows上部署AutoGLM时，通过adb命令检查设备连接状态的操作步骤。
python main.py --base-url https://api-inference.modelscope.cn/v1 --model "ZhipuAI/AutoGLM-Phone-9B" --apikey "your-modelscope-api-key" "打开小红书搜索AI智能体"
Demo录屏展示效果
两个视频是分开的，请结合一起看就能明白整个执行过程了。
Demo-PC版
对应的是CMD通过Python命令执行的整个过程
Demo-手机版
对应的是手机端的整个控制过程
