Open-AutoGLM参数详解：base-url、device-id等关键配置说明
1. 引言
1.1 技术背景与应用场景
随着多模态大模型的快速发展，AI Agent 正从文本交互迈向真实设备操作。Open-AutoGLM 是由智谱开源的一款面向手机端的 AI 智能体框架，基于 AutoGLM 视觉语言模型构建，能够理解安卓设备屏幕内容，并通过自然语言指令驱动自动化任务执行。用户只需输入“打开小红书搜索美食”这类语句，系统即可自动解析意图、识别界面元素、规划操作路径并完成点击、滑动、输入等动作。
该框架结合了视觉感知、语义理解与动作决策三大能力，依托 ADB（Android Debug Bridge）实现对安卓设备的精准控制，适用于自动化测试、智能助手、远程运维等多种场景。其核心优势在于将复杂的操作流程抽象为自然语言指令，极大降低了人机交互门槛。
1.2 核心价值与技术亮点
Open-AutoGLM 的设计目标是打造一个可扩展、易部署、高可用的手机端 AI Agent 控制平台。它不仅支持本地 USB 连接，还提供 WiFi 远程调试能力，便于开发者在不同网络环境下进行开发和测试。同时，系统内置敏感操作确认机制，在涉及隐私或关键操作时允许人工介入，保障安全性。
本文将重点解析 Open-AutoGLM 中的关键运行参数，包括--device-id、--base-url等，帮助开发者正确配置环境、连接设备并调用云端推理服务，确保 AI 代理稳定运行。
2. 环境准备与设备连接
2.1 硬件与软件依赖
在使用 Open-AutoGLM 前，需完成以下基础环境搭建：
- 操作系统：Windows 或 macOS
- Python 版本：建议使用 Python 3.10 及以上版本
- 安卓设备：Android 7.0+ 的真机或模拟器
- ADB 工具：用于设备通信与控制
ADB 是 Android SDK 的一部分，可通过官方平台工具包下载。安装后需将其路径添加至系统环境变量，以便全局调用。
Windows 配置示例：
- 解压
platform-tools包。 - 打开“系统属性” → “高级” → “环境变量”。
- 在“系统变量”中找到
Path，新增 ADB 解压目录路径。 - 打开命令行，执行
adb version验证是否成功。
macOS 配置示例：
export PATH=${PATH}:~/Downloads/platform-tools可将上述命令写入.zshrc或.bash_profile文件以持久化生效。
2.2 手机端设置步骤
为确保 ADB 能正常控制设备，需在安卓手机上启用相关权限：
开启开发者模式
进入“设置” → “关于手机” → 连续点击“版本号”7次，提示“您已进入开发者模式”。启用 USB 调试
返回“设置”主菜单 → “开发者选项” → 开启“USB 调试”。安装 ADB Keyboard（可选但推荐）
下载并安装 ADB Keyboard APK，用于接收来自 ADB 的文本输入指令。安装后进入“语言与输入法”设置，将默认输入法切换为 ADB Keyboard。
3. 控制端部署与设备连接
3.1 克隆项目与依赖安装
在本地电脑上克隆 Open-AutoGLM 仓库并安装所需依赖：
git clone https://github.com/zai-org/Open-AutoGLM cd Open-AutoGLM pip install -r requirements.txt pip install -e .此过程会安装 PyTorch、transformers、adbutils 等核心库，并将当前项目注册为可导入模块。
3.2 设备连接方式详解
Open-AutoGLM 支持两种设备连接模式：USB 直连与 WiFi 远程连接。
USB 连接方式
最简单稳定的连接方式，适合初期调试。
adb devices执行后应输出类似如下结果：
List of devices attached ABCDEF1234567890 device其中ABCDEF1234567890即为设备 ID，后续作为--device-id参数传入。
WiFi 远程连接方式
适用于无线调试或远程控制场景，需先通过 USB 启动 TCP/IP 模式。
# 第一步：使用 USB 连接，启动 ADB over TCP/IP adb tcpip 5555 # 第二步：断开 USB，通过 IP 地址连接 adb connect 192.168.x.x:5555连接成功后，同样可通过adb devices查看设备状态。
注意：设备必须与电脑处于同一局域网下，且防火墙未阻止 5555 端口。
4. 核心参数解析与运行配置
4.1 --device-id 参数说明
--device-id用于指定目标安卓设备的唯一标识符，可以是：
- USB 设备 ID：如
ABCDEF1234567890 - WiFi 连接地址：如
192.168.1.100:5555
该参数直接影响 ADB 是否能正确识别并控制设备。若设备未出现在adb devices列表中，则无法建立连接。
获取设备 ID 方法
from phone_agent.adb import list_devices devices = list_devices() for device in devices: print(f"ID: {device.device_id}, Type: {device.connection_type.value}")输出示例：
ID: 192.168.1.100:5555, Type: remote4.2 --base-url 参数详解
--base-url指定 AI 模型推理服务的 API 接入地址，格式为：
http://<服务器IP>:<端口>/v1例如：
--base-url http://123.45.67.89:8800/v1该 URL 指向运行 vLLM 或其他兼容 OpenAI API 协议的服务端点。Open-AutoGLM 通过此接口发送多模态请求（包含截图与指令），获取模型返回的操作建议。
关键注意事项：
- 必须确保云服务器已开放对应端口（如 8800）
- 服务端需启用 CORS 和跨域访问支持
- 推荐使用 HTTPS + 认证机制提升安全性（当前版本暂未内置认证）
4.3 --model 参数说明
--model参数用于声明所使用的模型名称，目前支持：
"autoglm-phone-9b"：主推的 90 亿参数视觉语言模型，专为手机操作任务优化- 其他自定义模型别名（需服务端注册）
该参数主要用于日志记录和服务路由，实际模型加载由服务端决定。
4.4 完整启动命令示例
python main.py \ --device-id 192.168.1.100:5555 \ --base-url http://123.45.67.89:8800/v1 \ --model "autoglm-phone-9b" \ "打开抖音搜索抖音号为：dycwo11nt61d 的博主并关注他！"各参数含义如下：
| 参数 | 说明 |
|---|---|
--device-id | ADB 设备标识，支持 USB ID 或 IP:port |
--base-url | 云端模型服务地址，需包含/v1路径 |
--model | 模型名称，用于请求标识 |
| 最后字符串 | 用户自然语言指令 |
5. Python API 编程接口使用指南
除了命令行方式，Open-AutoGLM 还提供了完整的 Python API，便于集成到自有系统中。
5.1 ADB 连接管理
from phone_agent.adb import ADBConnection, list_devices # 创建连接管理器 conn = ADBConnection() # 连接远程设备 success, message = conn.connect("192.168.1.100:5555") print(f"连接状态: {message}") # 列出所有已连接设备 devices = list_devices() for device in devices: print(f"{device.device_id} - {device.connection_type.value}")5.2 启用 TCP/IP 与获取 IP
对于仅支持 USB 的设备，可通过 API 动态开启远程调试：
# 在 USB 连接状态下启用 TCP/IP success, message = conn.enable_tcpip(5555) if success: ip = conn.get_device_ip() print(f"设备 IP: {ip}") else: print(f"启用失败: {message}")5.3 断开连接
conn.disconnect("192.168.1.100:5555")这些 API 为构建自动化调度系统、远程监控平台提供了灵活的基础能力。
6. 常见问题与排查建议
6.1 连接类问题
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
adb devices无设备显示 | 未开启 USB 调试 | 检查开发者选项中的“USB 调试”是否开启 |
| 连接被拒绝 (connection refused) | 防火墙阻断或端口未映射 | 检查云服务器安全组规则，放行对应端口 |
| ADB 掉线频繁 | WiFi 信号不稳定 | 改用 USB 连接，或优化网络环境 |
6.2 模型服务问题
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 模型响应乱码或超时 | vLLM 启动参数不匹配 | 检查max-model-len、显存分配、tokenizer 设置 |
| 返回空操作序列 | 输入图像异常或指令模糊 | 检查截图质量，优化指令表述清晰度 |
| 请求报错 404 | base-url 路径错误 | 确保 URL 包含/v1路径，且服务端启用 OpenAI 兼容接口 |
6.3 安全与稳定性建议
- 敏感操作拦截：系统默认对支付、删除等操作进行二次确认，避免误触
- 人工接管机制：在验证码、登录弹窗等场景下暂停自动执行，等待用户干预
- 日志追踪：所有操作均生成详细日志，便于回溯与调试
7. 总结
7.1 核心要点回顾
本文系统介绍了 Open-AutoGLM 的部署流程与关键参数配置方法。重点包括：
--device-id：指定设备连接标识，支持 USB ID 与 IP:port 两种形式--base-url：指向云端模型服务的 OpenAI 兼容接口，需确保网络可达- ADB 配置：正确安装工具链、开启调试权限是前提条件
- 运行模式选择：USB 适合本地调试，WiFi 更利于远程部署
7.2 最佳实践建议
- 优先使用 USB 进行初始调试，避免网络波动影响稳定性
- 定期检查服务端日志，及时发现模型响应异常
- 对复杂指令分步测试，提高成功率
- 结合 ADB Keyboard 实现文本输入自动化
Open-AutoGLM 为手机端 AI Agent 提供了一个强大而灵活的框架，合理配置各项参数是保障其高效运行的关键。随着多模态模型能力持续增强，未来有望在更多真实场景中实现“说即所得”的智能交互体验。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
