Open-AutoGLM参数详解：base-url、device-id等关键配置说明

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 配置示例：

1. 解压platform-tools包。
2. 打开“系统属性” → “高级” → “环境变量”。
3. 在“系统变量”中找到Path，新增 ADB 解压目录路径。
4. 打开命令行，执行adb version验证是否成功。

macOS 配置示例：

export PATH=${PATH}:~/Downloads/platform-tools

可将上述命令写入.zshrc或.bash_profile文件以持久化生效。

2.2 手机端设置步骤

为确保 ADB 能正常控制设备，需在安卓手机上启用相关权限：

1. 开启开发者模式
   进入“设置” → “关于手机” → 连续点击“版本号”7次，提示“您已进入开发者模式”。

2. 启用 USB 调试
   返回“设置”主菜单 → “开发者选项” → 开启“USB 调试”。

3. 安装 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: remote

4.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 的博主并关注他！"

各参数含义如下：

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 连接类问题

6.2 模型服务问题

6.3 安全与稳定性建议

• 敏感操作拦截：系统默认对支付、删除等操作进行二次确认，避免误触
• 人工接管机制：在验证码、登录弹窗等场景下暂停自动执行，等待用户干预
• 日志追踪：所有操作均生成详细日志，便于回溯与调试

7. 总结

7.1 核心要点回顾

本文系统介绍了 Open-AutoGLM 的部署流程与关键参数配置方法。重点包括：

• --device-id：指定设备连接标识，支持 USB ID 与 IP:port 两种形式
• --base-url：指向云端模型服务的 OpenAI 兼容接口，需确保网络可达
• ADB 配置：正确安装工具链、开启调试权限是前提条件
• 运行模式选择：USB 适合本地调试，WiFi 更利于远程部署

7.2 最佳实践建议

1. 优先使用 USB 进行初始调试，避免网络波动影响稳定性
2. 定期检查服务端日志，及时发现模型响应异常
3. 对复杂指令分步测试，提高成功率
4. 结合 ADB Keyboard 实现文本输入自动化

Open-AutoGLM 为手机端 AI Agent 提供了一个强大而灵活的框架，合理配置各项参数是保障其高效运行的关键。随着多模态模型能力持续增强，未来有望在更多真实场景中实现“说即所得”的智能交互体验。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。