Mac用户专属教程：Open-AutoGLM部署全流程-编程阁

Mac用户专属教程：Open-AutoGLM部署全流程

本文专为Mac用户定制，全程适配macOS系统特性，避开Windows常见坑点，从零开始手把手完成Open-AutoGLM本地部署与真机控制。无需显卡、不依赖云服务，所有操作均可在M1/M2/M3芯片Mac上稳定运行。

1. 为什么Mac用户需要这份专属教程？

AutoGLM-Phone不是普通AI模型，而是一个能“看懂手机屏幕+理解自然语言+自动点击滑动”的多模态智能体。但官方文档默认以Windows视角编写——环境变量配置路径不同、ADB权限机制差异、Shell终端行为不一致、甚至Homebrew与pip的包冲突，都可能让Mac新手卡在第一步。

本教程已实测验证于macOS Sonoma（14.5）+ M1 Pro芯片环境，所有命令均通过zsh终端原生执行，规避了bash兼容性问题；所有路径采用Mac标准格式（~/Downloads而非C:\adb）；所有报错场景均附带Mac专属解决方案。你不需要懂底层原理，只要按步骤敲命令，就能让AI接管你的安卓手机。

2. Mac专属环境准备：三步到位

2.1 安装Python 3.10+（推荐Homebrew方式）

Mac用户切勿直接下载Python官网安装包——它会与系统预装Python冲突，且无法被Homebrew统一管理。

# 1. 确保Homebrew已安装（如未安装，执行此命令） /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 2. 安装Python 3.10（自动配置PATH，无需手动设置） brew install python@3.10 # 3. 验证安装（输出应为 Python 3.10.x） python3 --version # 4. 创建软链接，使'python'命令指向3.10版本（避免后续pip冲突） sudo ln -sf /opt/homebrew/bin/python3.10 /opt/homebrew/bin/python

关键提示：Mac的/opt/homebrew/bin/是Apple Silicon芯片默认路径；Intel芯片用户路径为/usr/local/bin/，请根据which brew结果调整。

2.2 配置ADB工具（Mac版极简流程）

ADB在Mac上无需解压复杂压缩包，Homebrew一键安装即可：

# 安装platform-tools（含adb、fastboot等核心工具） brew install android-platform-tools # 验证安装（输出adb version信息即成功） adb version # 检查是否已加入PATH（Mac默认已配置，无需额外export） echo $PATH | grep homebrew

注意：Mac的ADB无需手动配置环境变量！Homebrew安装后自动写入~/.zprofile，重启终端或执行source ~/.zprofile即可生效。

2.3 手机端设置：Mac用户专属避坑指南

安卓手机连接Mac时，常因USB协议兼容性失败。请严格按以下顺序操作：

开启开发者模式
设置 → 关于手机 → 连续点击“版本号”7次 → 输入锁屏密码 → 返回设置页确认“开发者选项”已出现。
启用USB调试并授权Mac
设置 → 开发者选项 → 打开“USB调试” →勾选“USB调试（安全设置）”（此选项Mac必备，Windows可忽略）。
首次连接关键操作
- 用原装USB-C数据线连接Mac与手机
- 手机弹出“允许USB调试吗？”提示 →勾选“始终允许来自这台计算机”→ 点击“确定”
- 终端执行adb devices，若显示xxxxxx device（非???????? no permissions）即成功

排查技巧：若仍显示no permissions，执行sudo adb kill-server && sudo adb start-server，再重新插拔数据线。

3. Open-AutoGLM项目部署：Mac优化版

3.1 克隆代码库并安装依赖

# 1. 创建专用工作目录（避免中文路径导致编码错误） mkdir -p ~/Projects/ai-phone cd ~/Projects/ai-phone # 2. 克隆Open-AutoGLM（使用SSH加速国内访问） git clone git@github.com:zai-org/Open-AutoGLM.git cd Open-AutoGLM # 3. 安装依赖（跳过Windows专属包，适配Mac原生环境） pip install -r requirements.txt # 4. 以开发模式安装（支持本地修改实时生效） pip install -e . # 5. 验证安装（无报错即成功） python -c "from phone_agent.adb import ADBConnection; print(' Open-AutoGLM安装成功')"

提示：Mac用户无需安装pywin32等Windows包，requirements.txt中已通过platform-system != 'Windows'自动过滤。

3.2 下载并启动AutoGLM-Phone-9B模型

该模型约18GB，国内用户强烈推荐ModelScope镜像源（比Hugging Face快5倍以上）：

# 1. 安装ModelScope（阿里开源模型平台） pip install modelscope # 2. 下载模型（自动处理分片、校验、缓存） from modelscope.pipelines import pipeline from modelscope.utils.constant import Tasks # 在Python中执行（或保存为download_model.py后运行） # 此步骤会自动下载至~/.cache/modelscope/hub/ZhipuAI/AutoGLM-Phone-9B pipeline(task=Tasks.visual_grounding, model='ZhipuAI/AutoGLM-Phone-9B')

替代方案（命令行直接下载）：
git clone https://www.modelscope.cn/ZhipuAI/AutoGLM-Phone-9B.git

3.3 启动vLLM推理服务（Mac M系列芯片适配）

M1/M2/M3芯片需启用--device cpu参数（GPU加速暂未完全适配），并降低内存占用：

# 创建启动脚本 start_model.sh（Mac原生兼容） cat > start_model.sh << 'EOF' #!/bin/zsh python3 -m vllm.entrypoints.openai.api_server \ --served-model-name autoglm-phone-9b \ --model ./AutoGLM-Phone-9B \ --port 8000 \ --device cpu \ --max-model-len 16384 \ --tensor-parallel-size 1 \ --enforce-eager \ --kv-cache-dtype fp16 EOF # 添加执行权限并运行 chmod +x start_model.sh ./start_model.sh

成功标志：终端输出Uvicorn running on http://0.0.0.0:8000且无CUDA相关报错。

4. 真机控制实战：从“打开设置”到自动化任务

4.1 USB直连模式：最稳定的基础测试

# 1. 确认设备已连接 adb devices # 2. 执行首条指令（测试基础功能） python main.py \ --base-url http://localhost:8000/v1 \ --model "autoglm-phone-9b" \ "打开设置" # 3. 观察手机：设置App应自动启动，终端输出类似： # 💭 思考过程: 当前在桌面，需要打开设置应用 # 执行动作: {"action": "Launch", "app": "设置"}

若失败，请检查：① 手机是否亮屏未锁屏 ② ADB Keyboard是否设为默认输入法 ③ 终端是否在Open-AutoGLM目录下。

4.2 WiFi远程控制：摆脱数据线束缚

Mac与手机同连WiFi时，可实现无线操控（适合演示/多设备管理）：

# 1. 首次需USB连接启用TCP/IP adb tcpip 5555 # 2. 断开USB，获取手机IP（手机设置→Wi-Fi→点击当前网络→查看IP地址） # 假设IP为 192.168.1.100 # 3. 无线连接设备 adb connect 192.168.1.100:5555 # 4. 验证连接 adb devices # 应显示 192.168.1.100:5555 device # 5. 执行无线指令 python main.py \ --device-id 192.168.1.100:5555 \ --base-url http://localhost:8000/v1 \ --model "autoglm-phone-9b" \ "打开小红书搜索‘咖啡探店’"

注意：Mac防火墙可能拦截ADB连接。若失败，前往「系统设置→隐私与安全性→防火墙→防火墙选项」，勾选adb和python。

4.3 中文输入专项配置（Mac用户高频痛点）

ADB Keyboard在Mac上需额外启用输入法切换：

手机安装ADBKeyboard.apk（从GitHub Release下载）
终端执行adb install ADBKeyboard.apk
手机设置 → 通用 → 键盘 → 虚拟键盘 → 启用“ADB Keyboard”
关键步骤：长按手机空格键 → 切换至“ADB Keyboard” → 此时AI才能输入中文

验证：执行python main.py ... "搜索‘iPhone 15’"，观察手机搜索框是否正确输入中文。

5. 敏感操作与安全机制：Mac用户的安心保障

AutoGLM-Phone内置双保险机制，专为Mac用户本地部署设计：

5.1 自动化敏感操作拦截

当指令涉及支付、删除、隐私读取时，AI会主动暂停并等待确认：

# 执行高风险指令（如支付） python main.py \ --base-url http://localhost:8000/v1 \ --model "autoglm-phone-9b" \ "在美团下单一份火锅外卖" # 终端将输出： # 需要确认: 即将支付¥68.5，是否继续？(y/n): # 此时需手动输入 y 回车，AI才继续执行

5.2 Mac本地隐私保护策略

零数据上传：所有屏幕截图、界面解析、操作日志均在Mac本地处理，不经过任何第三方服务器
ADB权限隔离：通过adb -P 5037指定独立端口，避免与其他ADB进程冲突
模型文件沙箱：模型存储于~/Library/Caches/Open-AutoGLM，遵循macOS隐私规范

建议：在「系统设置→隐私与安全性→开发者工具」中，仅授权Terminal和Python访问辅助功能。

6. 故障排查：Mac用户TOP5报错及解决方案

报错现象	根本原因	Mac专属解决方案
`adb: command not found`	Homebrew未初始化PATH	执行`echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && source ~/.zprofile`
`OSError: [Errno 48] Address already in use`	端口8000被占用	`lsof -i :8000 \| awk '{print $2}' \| tail -n +2 \| xargs kill -9`
`ModuleNotFoundError: No module named 'vllm'`	vLLM未安装或架构不匹配	`pip uninstall vllm && pip install --no-binary=vllm vllm`（强制源码编译）
`Permission denied: '/dev/tty.*'`	USB串口权限不足	`sudo chmod 777 /dev/tty.*`（临时）或`sudo dseditgroup -o edit -a $(whoami) -t user dialout`（永久）
`Connection refused`（连接手机失败）	macOS Monterey+系统限制	前往「系统设置→隐私与安全性→辅助功能」，勾选`Terminal`和`adb`

终极方案：重置ADB服务
adb kill-server && sudo adb start-server && adb devices

7. 进阶技巧：让Mac成为AI手机中枢

7.1 使用Automator创建一键启动工作流

将模型启动、ADB连接、指令执行封装为Mac快捷操作：

打开「自动操作」App → 新建「快速操作」

添加操作：「运行Shell脚本」→ 粘贴以下内容：

cd ~/Projects/ai-phone/Open-AutoGLM ./start_model.sh & sleep 10 python main.py --base-url http://localhost:8000/v1 --model "autoglm-phone-9b" "$1"

保存为「AI手机助手」→ 右键任意文本选择该快捷操作，自动执行指令

7.2 通过Alfred实现语音控制（Mac原生集成）

安装Alfred Powerpack
创建Workflow：触发词ai→ 执行脚本python ~/Projects/ai-phone/Open-AutoGLM/main.py --base-url ... "$1"
对Mac说：“Hey Alfred, ai 打开微信给爸爸发消息‘我到家了’”

效果：Mac秒变AI手机指挥中心，无需打开终端。

8. 总结：你已掌握Mac端AI手机的核心能力

通过本教程，你已完成：

环境筑基：Python 3.10+、ADB、开发者模式的Mac原生配置
模型落地：AutoGLM-Phone-9B在M系列芯片上的稳定推理服务
真机贯通：USB/WiFi双模式控制安卓手机，支持中文输入
安全实践：敏感操作人工确认、本地数据零上传的隐私保障
效率跃迁：Automator/Alfred集成，让AI手机真正融入Mac工作流

下一步建议：
🔹新手：尝试「订外卖」「查快递」「刷抖音」等生活场景指令
🔹进阶者：修改phone_agent/config/prompts.py，让AI更懂你的表达习惯
🔹开发者：研究phone_agent/planner/下的规划算法，贡献多APP支持

AI手机不是未来科技，而是你Mac上已就绪的生产力伙伴——现在，拿起手机，对它说一句：“打开小红书，搜‘Mac效率神器’”。

--- > **获取更多AI镜像** > > 想探索更多AI镜像和应用场景？访问 [CSDN星图镜像广场](https://ai.csdn.net/?utm_source=mirror_blog_end)，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。

Mac用户专属教程：Open-AutoGLM部署全流程