最近 OpenClaw 项目热度很高，我也开始学习和探索。本文记录了我学习过程中，将 Android 设备接入 OpenClaw Gateway 的完整流程，涵盖了环境准备、应用编译、Gateway 配置及最终连接，并特别记录了针对较旧 Android 设备的适配方法。
- 在 Android 手机上安装并运行 OpenClaw 客户端；
- 将手机设备接入本地 OpenClaw Gateway；
✅ 适用于个人开发、远程调试、家庭自动化场景。
1. 环境要求
JDK 21 (Windows) Gradle 8.0+ Android SDK Tools , Android 手机 支持
Android 10 (API 29)，已开启 USB 调试
我们需要为 OpenClaw 官方 Android 应用进行编译与安装。
1. 安装 Android SDK 工具
2. 克隆 OpenClaw 代码仓库
进入 Android 应用目录：
3. 适配旧版 Android 设备 (重要)
由于我的 Android 设备较旧，需要对源码进行关键修改以确保兼容性。
修改一：降低最低支持版本 (minSdk)
打开 文件，将 从默认值修改为 。
✅ 这样做是为了兼容 Android 10 (API 29) 及更高版本的设备。
修改二：禁用动态颜色 (Dynamic Color)
打开 文件，将 的判断逻辑修改如下。
这个修改至关重要，因为 Android 12 (API 31) 以下的系统不支持 Material You 的动态颜色主题，会导致应用崩溃。
✅ 通过此修改，应用将只为 Android 12 及以上系统启用动态颜色，旧系统则使用预设的主题色，保证了应用的稳定运行。
4. 编译并安装 APK
确保你的手机已开启 开发者选项 和 USB 调试模式，并通过 USB 连接电脑。
执行以下命令编译并安装：
✅ 成功后，手机会自动安装名为 “OpenClaw” 的应用。
1. 修改
在 OpenClaw 根目录下找到 文件，添加或修改如下内容：
2. 启动 Gateway
此时服务将在 上启动，并显示连接状态页。
1. 设置 OpenClaw 环境变量（可选）
如果你希望绕过 TLS 验证（仅用于本地测试），可以设置：
⚠️ Windows 环境 使用 命令设置临时环境变量。
2. 初始化并生成连接信息
首先运行设置向导，它会引导你完成基本配置：
然后，根据向导结果或手动指定的 URL 和 Token，生成用于连接的二维码：
请将 替换为你运行 OpenClaw Gateway 的服务器或本机的实际 IP 地址。
3. 扫描二维码并授权
openclaw 配置打开手机上的 OpenClaw App，点击“扫描二维码”，扫描电脑端生成的 QR 码。
App 会提示你：
- 授权相机、麦克风、位置等权限；
- 点击“链接”按钮建立连接。
当设备发起连接后，它会处于待审批状态。你可以通过以下命令查看待处理的连接请求：
列表中会显示待批准的设备及其 。
执行批准命令，将 替换为实际的请求ID：
完成此步骤后，设备即被正式加入到你的 OpenClaw 网络中。
访问 Web 控制台：http://localhost:18789
你应该能看到：
- Active endpoint: 如
- Gateway state: — 表示设备已连接但尚未激活
- Disconnect Gateway 按钮可用
点击 Chat 标签页，即可发送消息测试通信是否正常。
注意：需要在 Android 上授予相机权限，且设备支持前置/后置摄像头。
- OpenClaw 官方文档 – Android 接入
- OpenClaw 节点管理
- OpenClaw 摄像头支持
- Android 官方开发工具文档
通过以上步骤，特别是针对旧版 Android 设备的关键代码修改，我成功地将一台 Android 10 设备接入了 OpenClaw 系统。
注意：本文只记录了如何完成设备的基本接入，至于接入后能用它来做什么、怎么深入玩转，我还在继续学习中。
关键词：OpenClaw, Android, 远程控制, 设备接入, 二维码连接, gateway, 摄像头, 安全认证, 低版本适配
如果你也在学习 OpenClaw，希望这篇记录对你有所帮助。
发布者：Ai探索者，转载请注明出处：https://javaforall.net/287445.html原文链接：https://javaforall.net
