Python 环境配置要求与创建步骤
版本要求
AutoGLM 官方文档建议使用 Python 3.10 及以上版本。低于 3.10 可能出现依赖不兼容或语法错误。推荐用 Anaconda 或 Python 内置 venv 创建独立环境，避免污染系统 Python。
创建虚拟环境
方式一：Python 内置 venv
python -m venv venv
# Windows 激活
venv\Scripts\activate
# macOS / Linux 激活
source venv/bin/activate方式二：Anaconda / Miniconda
conda create -n autoglm python=3.10 -y
conda activate autoglm克隆仓库与安装依赖
git clone https://github.com/zai-org/Open-AutoGLM.git
cd Open-AutoGLM
# 安装项目依赖
pip install -r requirements.txt
# 以可编辑模式安装框架本身（开发模式）
pip install -e .两条 pip 命令都必须跑：requirements.txt 装第三方库，pip install -e . 把 phone_agent 包注册到环境里，这样你才能在自己的 Python 脚本里 from phone_agent import PhoneAgent。
依赖清单
requirements.txt 里的核心依赖：
| 包名 | 用途 |
|---|---|
| httpx | OpenAI 兼容格式的模型 API 客户端 |
| Pillow | 截图图片处理（裁剪、缩放、格式转换） |
| pyyaml | 配置文件解析 |
| loguru | 日志输出 |
| rich | 终端美化输出 |
| pytest | 运行单元测试（二次开发时用） |
如果打算本地部署模型而不只是调用 API，还需要安装推理引擎（vLLM 或 SGLang），见 本地 vLLM 部署。
验证安装
进入 Python 环境后，简单 import 一下确认框架可用：
python -c "from phone_agent import PhoneAgent; print('Phone Agent 安装成功')"如果输出"Phone Agent 安装成功"，说明 Python 环境和框架本身没问题。接下来需要配置设备控制工具（ADB / HDC），见下一页。