OpenClaw 安卓设备接入指南：从零开始配置你的移动节点

最近 OpenClaw 项目热度很高我也开始学习和探索。本文记录了我学习过程中将 Android 设备接入 OpenClaw Gateway 的完整流程涵盖了环境准备、应用编译、Gateway 配置及最终连接并特别记录了针对较旧 Android 设备的适配方法。 学习目标在 Android 手机上安装并运行 OpenClaw 客户端将手机设备接入本地 OpenClaw Gateway✅ 适用于个人开发、远程调试、家庭自动化场景。 准备工作1. 环境要求组件版本/说明操作系统Linux / macOS / WindowsJava JDKJDK 21(Windows)Gradle8.0Android SDK Toolsplatform-tools,build-toolsAndroid 手机支持Android 10 (API 29)已开启 USB 调试 第一步搭建 Android 开发环境我们需要为 OpenClaw 官方 Android 应用进行编译与安装。1. 安装 Android SDK 工具# 使用 sdkmanager 安装必要的组件sdkmanagerplatform-toolsbuild-tools;34.0.02. 克隆 OpenClaw 代码仓库gitclone https://github.com/openclaw/openclaw.gitcdopenclaw进入 Android 应用目录cdapps/android3. 适配旧版 Android 设备 (重要)由于我的 Android 设备较旧需要对源码进行关键修改以确保兼容性。修改一降低最低支持版本 (minSdk)打开apps\android\app\build.gradle.kts文件将minSdk从默认值修改为29。android{// ...defaultConfig{applicationIdai.openclaw.appminSdk29// 修改这里对应 Android 10targetSdk34versionCode1versionName1.0// ...}// ...}✅ 这样做是为了兼容 Android 10 (API 29) 及更高版本的设备。修改二禁用动态颜色 (Dynamic Color)打开openclaw\apps\android\app\src\main\java\ai\openclaw\app\ui\OpenClawTheme.kt文件将dynamicColor的判断逻辑修改如下。这个修改至关重要因为 Android 12 (API 31) 以下的系统不支持 Material You 的动态颜色主题会导致应用崩溃。ComposablefunOpenClawTheme(darkTheme:BooleanisSystemInDarkTheme(),// 使用动态颜色需要 API 31dynamicColor:BooleanBuild.VERSION.SDK_INTBuild.VERSION_CODES.S,content:Composable()-Unit){valcolorSchemewhen{// 动态颜色仅支持 Android 12dynamicColorBuild.VERSION.SDK_INTBuild.VERSION_CODES.S-{if(darkTheme){androidx.compose.material3.dynamicDarkColorScheme(LocalContext.current)}else{androidx.compose.material3.dynamicLightColorScheme(LocalContext.current)}}darkTheme-darkColorScheme()else-lightColorScheme()}MaterialTheme(colorSchemecolorScheme,contentcontent)}✅ 通过此修改应用将只为 Android 12 及以上系统启用动态颜色旧系统则使用预设的主题色保证了应用的稳定运行。4. 编译并安装 APK确保你的手机已开启开发者选项和USB 调试模式并通过 USB 连接电脑。执行以下命令编译并安装./gradlew :app:assembleDebug ./gradlew :app:installDebug✅ 成功后手机会自动安装名为 “OpenClaw” 的应用。⚙️ 第二步配置 OpenClaw Gateway1. 修改config.json在 OpenClaw 根目录下找到config.json文件添加或修改如下内容{gateway:{port:18789,mode:local,bind:lan,controlUi:{allowedOrigins:[http://127.0.0.1:18789]},auth:{mode:token,token:your-secret-token-here},nodes:{denyCommands:[screen.record,contacts.add,calendar.add,reminders.add,sms.send]}}}token可自定义建议使用强随机字符串例如openssl rand -base64 32生成。denyCommands列表可防止敏感操作被远程触发提升安全性。2. 启动 Gatewaynpmrun start此时服务将在http://localhost:18789上启动并显示连接状态页。 第三步生成二维码并连接设备1. 设置 OpenClaw 环境变量可选如果你希望绕过 TLS 验证仅用于本地测试可以设置setOPENCLAW_ALLOW_INSECURE_PRIVATE_WS1⚠️Windows 环境使用set命令设置临时环境变量。2. 初始化并生成连接信息首先运行设置向导它会引导你完成基本配置openclaw setup然后根据向导结果或手动指定的 URL 和 Token生成用于连接的二维码openclaw qr--urlws://YOUR_GATEWAY_IP:18789--tokenyour-secret-token-here 请将YOUR_GATEWAY_IP替换为你运行 OpenClaw Gateway 的服务器或本机的实际 IP 地址。3. 扫描二维码并授权打开手机上的OpenClaw App点击“扫描二维码”扫描电脑端生成的 QR 码。App 会提示你授权相机、麦克风、位置等权限点击“链接”按钮建立连接。✅ 第四步批准设备连接当设备发起连接后它会处于待审批状态。你可以通过以下命令查看待处理的连接请求openclaw devices列表中会显示待批准的设备及其requestId。执行批准命令将REQUEST_ID替换为实际的请求IDopenclaw devices approve REQUEST_ID完成此步骤后设备即被正式加入到你的 OpenClaw 网络中。 第五步验证连接状态访问 Web 控制台http://localhost:18789你应该能看到Active endpoint: 如192.168.96.141:18789Gateway state:Connected (node offline)— 表示设备已连接但尚未激活Disconnect Gateway按钮可用点击Chat标签页即可发送消息测试通信是否正常。注意需要在 Android 上授予相机权限且设备支持前置/后置摄像头。 参考资料OpenClaw 官方文档 - Android 接入OpenClaw 节点管理OpenClaw 摄像头支持Android 官方开发工具文档 总结通过以上步骤特别是针对旧版 Android 设备的关键代码修改我成功地将一台 Android 10 设备接入了 OpenClaw 系统。注意本文只记录了如何完成设备的基本接入至于接入后能用它来做什么、怎么深入玩转我还在继续学习中。关键词OpenClaw, Android, 远程控制, 设备接入, 二维码连接, gateway, 摄像头, 安全认证, 低版本适配如果你也在学习 OpenClaw希望这篇记录对你有所帮助。