AutoGLM-Phone输入法配置：ADB Keyboard安装避坑指南

想让你的手机拥有一个能“看懂”屏幕、听懂指令并自动操作的AI助理吗？AutoGLM-Phone（Phone Agent）让这个想法变成了现实。这是一个基于智谱开源视觉语言模型构建的手机端智能助理框架，它能以多模态方式理解你的手机屏幕内容，然后通过ADB（Android调试桥）自动操控设备。

简单来说，你只需要用自然语言告诉它“打开小红书搜美食”，它就能自己解析你的意图、理解当前界面、规划操作步骤，并自动执行整个流程，完全不需要你手动点击。听起来很酷，对吧？

但在让AI接管你的手机之前，有一个关键步骤常常被忽略，却又是整个自动化流程的基石：配置ADB Keyboard输入法。很多人在这一步遇到各种“坑”，导致后续的AI操作无法正常输入文字。本文将手把手带你完成ADB Keyboard的安装与配置，并分享我趟过的所有坑，确保你的AutoGLM-Phone能顺利“开口说话”。

1. 为什么ADB Keyboard如此关键？

在开始动手之前，我们先花一分钟理解一下核心原理。这能帮你明白为什么必须用这个特殊的输入法，而不是手机自带的。

传统输入法 vs. ADB Keyboard

想象一下，你平时在手机上打字，手指触摸屏幕，输入法应用接收触摸事件，然后在当前光标位置弹出键盘、显示候选词。这个过程依赖于Android系统的图形界面和触摸事件体系。

而AutoGLM-Phone这类自动化工具，是通过电脑上的ADB命令来远程控制手机的。ADB提供了一种底层指令，可以直接向系统“注入”文本，完全绕过图形界面和触摸事件。但这里有个问题：大多数普通输入法应用无法接收来自ADB的文本注入指令。它们只在用户通过屏幕交互时才被激活。

ADB Keyboard 就是一个专门为解决这个问题而生的输入法。它充当了一个“桥梁”或“接收器”：

1. 它将自己注册为系统的一个输入法服务。
2. 它监听来自ADB adb shell input text 这类命令发送的文本。
3. 接收到文本后，它模拟键盘输入，将字符准确地输入到当前获得焦点的输入框里。

如果没有ADB Keyboard，当你通过AutoGLM-Phone发出“在搜索框输入‘北京美食’”的指令时，AI能识别搜索框，但无法在其中填入任何文字，整个自动化流程就会卡住。

所以，配置ADB Keyboard是打通“AI决策”到“手机执行”这最后一公里的必经之路。

2. 环境与工具准备

工欲善其事，必先利其器。我们先确保电脑和手机端的基础环境就绪。

2.1 电脑端：安装ADB工具

ADB是连接电脑和手机的通信桥梁。无论你用什么操作系统，都需要先安装它。

对于Windows用户：

1. 下载ADB工具包：访问Android开发者官网或使用可靠的第三方镜像，下载“Platform-Tools”包并解压到任意目录，例如 C:\platform-tools。
2. 配置环境变量（关键步骤）：
   • 右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
   • 在“系统变量”区域，找到并选中Path变量，点击“编辑”。
   • 点击“新建”，将你的ADB工具解压路径（如 C:\platform-tools）添加进去。
   • 一路点击“确定”保存。
3. 验证安装：打开命令提示符（CMD）或PowerShell，输入 adb version 并回车。如果显示出版本信息（如 Android Debug Bridge version 1.0.41），则说明配置成功。

对于macOS/Linux用户： 通常可以通过包管理器更简单地安装。

# macOS 使用 Homebrew
brew install android-platform-tools

# Ubuntu/Debian 使用 apt
sudo apt update
sudo apt install android-tools-adb

安装后，同样在终端输入 adb version 验证。

2.2 手机端：开启开发者选项与USB调试

要让电脑通过ADB控制手机，需要在手机上打开“开发者模式”并启用“USB调试”。

1. 开启开发者选项：

   • 进入手机的 设置 > 关于手机。
   • 连续点击 “版本号” 7次（不同品牌手机可能略有差异，如小米是点击“MIUI版本”）。
   • 直到屏幕提示“您已处于开发者模式”或类似信息。

2. 启用USB调试：

   • 返回设置菜单，现在你应该能看到新增的 “开发者选项” 或 “系统开发者选项”。
   • 进入后，找到并开启 “USB调试” 开关。
   • 重要：在弹出的安全警告对话框中，选择“允许”或“确定”。

3. ADB Keyboard安装与配置全流程

这是本文的核心部分，我们将一步步完成ADB Keyboard的安装、设置，并解决可能出现的所有问题。

3.1 获取ADB Keyboard安装包

ADB Keyboard是一个开源项目，你需要下载它的APK安装文件。

• 官方GitHub仓库：在GitHub上搜索 senzhk/ADBKeyBoard，在项目的 Releases 页面下载最新的 .apk 文件。
• 注意版本：确保下载的是 ADBKeyBoard.apk 主程序文件，而不是源码。

将下载好的 ADBKeyBoard.apk 文件放在电脑上你容易找到的目录，比如桌面。

3.2 连接手机并安装APK

1. 使用USB数据线将手机连接到电脑。

2. 在手机上，当出现“允许USB调试吗？”的弹窗时，勾选“始终允许”，并点击“确定”。这是建立信任关系的关键一步。

3. 打开电脑上的命令行（CMD或终端），输入以下命令检查设备是否被识别：

   adb devices
   

   • 成功连接：你会看到类似 List of devices attached 下面有一行设备ID，后面跟着 device 字样。
   • 未授权：如果后面显示 unauthorized，请检查手机上的授权弹窗，或者重新插拔USB线。
   • 无设备：如果列表为空，请检查USB连接、驱动程序（Windows可能需要安装手机品牌驱动）或开发者选项是否已开启。

4. 安装APK：在命令行中，使用 adb install 命令进行安装。你需要指定APK文件的完整路径。

   # Windows 示例，假设apk在桌面
   adb install C:\Users\你的用户名\Desktop\ADBKeyBoard.apk
   
   # macOS/Linux 示例
   adb install ~/Desktop/ADBKeyBoard.apk
   

   看到 Success 提示即表示安装成功。

3.3 在手机上启用ADB Keyboard输入法

安装只是第一步，接下来需要将其设为可用的输入法，并切换为默认输入法。

1. 进入输入法设置：

   • 打开手机 设置，进入 “系统设置” 或 “附加设置”。
   • 找到 “语言与输入法” 或 “虚拟键盘” 选项（不同手机名称可能不同，如“输入法”、“键盘”）。

2. 启用ADB Keyboard：

   • 在“输入法”或“键盘”列表里，找到 “ADB Keyboard” 或 “ADBKeyBoard”。
   • 打开它的开关，系统可能会提示一些关于输入法的权限警告，全部选择“允许”或“确定”。

3. 切换默认输入法（最关键的一步）：

   • 在“语言与输入法”设置页面，找到 “默认输入法” 或 “当前输入法” 选项。
   • 点击进入，从列表中选择 “ADB Keyboard”。
   • 重要提示：切换后，你手机自带的输入法（如搜狗、Gboard等）会被暂时禁用。你会发现屏幕下方不会弹出常规的软键盘了。这是正常现象，意味着ADB Keyboard正在工作。

4. 实战测试与避坑指南

安装配置完成后，必须进行测试，确保ADB Keyboard能正常工作。

4.1 基础功能测试

1. 在手机上打开任何一个可以输入文字的App，比如便签或浏览器地址栏。
2. 点击输入框，确保光标在闪烁。
3. 在电脑的命令行中，输入以下命令：

   adb shell input text "Hello, AutoGLM!"
   

4. 立即查看手机屏幕。如果配置正确，你会在输入框中看到 Hello, AutoGLM! 这段文字被自动输入，全程没有弹出任何键盘。

恭喜！ 如果测试成功，说明ADB Keyboard已经完美就绪，AutoGLM-Phone已经具备了远程输入文字的能力。

4.2 常见问题与解决方案（避坑重点）

在实际操作中，你可能会遇到以下问题，这里提供了详细的解决方案。

问题1：执行 adb shell input text 命令后，手机无反应，文字没有输入。

• 可能原因A：默认输入法未切换。
  • 排查：回到手机“默认输入法”设置，确认当前选中的是 “ADB Keyboard”，而不是其他输入法。
  • 解决：重新切换并确认。
• 可能原因B：ADB Keyboard未被激活。
  • 排查：有些系统在锁屏或长时间不操作后，会禁用后台输入法。点击输入框，观察通知栏或系统状态栏是否有输入法切换的提示。
  • 解决：可以尝试在命令行中手动激活一下（需要手机已root或授予特殊权限，较复杂）。更简单的方法是：在手机输入法设置中，先切换到系统输入法打几个字，再切回ADB Keyboard，然后立刻用电脑ADB命令测试。
• 可能原因C：ADB连接不稳定。
  • 排查：再次运行 adb devices，确认设备状态仍是 device。
  • 解决：重新插拔USB线，或在手机上撤销USB调试授权后重新连接。

问题2：输入的内容是乱码或包含奇怪字符。

• 可能原因：ADB Keyboard版本与系统或ADB工具存在编码兼容性问题。
• 解决：
  1. 尝试从GitHub下载另一个版本的ADB Keyboard APK。
  2. 对于中文输入，可以尝试将中文用URL编码后再发送，但这通常需要脚本配合。对于AutoGLM-Phone框架，它内部会处理编码问题，所以更可能是本地测试时的ADB工具问题。确保使用最新版的 platform-tools。

问题3：安装APK时失败，提示 INSTALL_FAILED_UPDATE_INCOMPATIBLE 等错误。

• 可能原因：手机中已存在旧版本或冲突的包。
• 解决：先尝试卸载旧版。

  adb uninstall com.android.adbkeyboard
  

  如果不知道包名，可以安装一个包名查看器App，或者直接尝试用 adb install -r（替换安装）命令。

问题4：想恢复使用正常输入法怎么办？

• 解决：非常简单，回到手机的 “设置 > 语言与输入法 > 默认输入法”，重新选择你常用的输入法（如搜狗输入法、Gboard等）即可。ADB Keyboard仍然保持安装和启用状态，下次需要自动化测试时再切换回来。

5. 与AutoGLM-Phone框架集成

当ADB Keyboard配置测试无误后，你就可以让它为AutoGLM-Phone这个大脑提供“手”和“嘴”的功能了。

回顾一下AutoGLM-Phone的启动命令：

python main.py \
  --device-id <你的设备ID> \
  --base-url http://<云服务器IP>:<端口>/v1 \
  --model "autoglm-phone-9b" \
  "打开抖音搜索抖音号为：dycwo11nt61d 的博主并关注他！"

在这个指令中，AI模型（autoglm-phone-9b）会：

1. 感知：通过ADB截图分析手机屏幕。
2. 规划：理解你的指令，分解出“打开抖音”、“点击搜索框”、“输入抖音号”、“搜索”、“点击用户”、“关注”等一系列步骤。
3. 执行：在需要输入的步骤（“输入抖音号”），框架底层就会调用 adb shell input text 命令。
4. 协作：此时，你手机上活跃的ADB Keyboard输入法就会接收到这个命令，并将“dycwo11nt61d”这串字符输入到抖音的搜索框中。

整个过程无缝衔接，你看到的就像是一个真人在流畅地操作手机。

6. 总结

配置ADB Keyboard是解锁AutoGLM-Phone完整自动化能力的关键一步，虽然过程有些琐碎，但一旦打通，后续的体验将非常流畅。我们来回顾一下核心要点：

1. 理解原理：ADB Keyboard是ADB命令与手机文本输入框之间的唯一桥梁，不可替代。
2. 严格配置：按照“安装APK -> 启用输入法 -> 设为默认”的顺序操作，每一步都要确认。
3. 务必测试：使用 adb shell input text 命令进行实测，确保文字能正确输入，这是验证成功与否的唯一标准。
4. 耐心排错：遇到问题，按照本文的“常见问题”部分逐一排查，大多集中在输入法切换和ADB连接上。

现在，你的手机已经准备好了。接下来，你就可以去部署AutoGLM-Phone的服务端和控制端，体验用自然语言指挥AI助理帮你完成各种手机操作的乐趣了。从自动回复消息、整理相册，到完成复杂的应用内操作流程，这一切都始于今天这步扎实的配置。祝你玩得开心！

---

获取更多AI镜像

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