Android

Android Node App 让你的安卓手机成为 OpenClaw 的移动节点。Android 平台功能灵活，但需要注意不同厂商的电池管理策略。

系统要求

项目	要求
Android 版本	10 (API 29) 及以上
设备	支持 ARM64 的主流手机
存储	150 MB 可用空间

安装方式

Google Play

在 Google Play 商店搜索 "OpenClaw Node" 下载。

APK Sideload（侧载安装）

从 GitHub Releases 下载 APK：

# 使用 adb 安装
adb install openclaw-node-v1.0.0.apk

🇨🇳 国内下载

国内无法访问 Google Play 的用户，可以从以下渠道下载：

• GitHub 镜像：https://github.com/openclaw/releases
• 国内应用商店搜索「OpenClaw 节点」（部分商店已上架）

配对连接

扫码配对

1. 在网关设备上生成 QR Code：

openclaw qr

2. 打开 Android App → 点击「扫码配对」→ 扫描二维码

手动配对

1. 在网关设备上生成配对码：

openclaw pairing --generate

2. 打开 Android App → 输入配对码 → 点击「连接」

远程连接

如果手机和网关不在同一网络：

# 网关开启远程访问
openclaw gateway --remote

# 在 App 中输入远程地址
# 例如：wss://your-domain.com:7681

节点功能

通知推送

channels:
  android_push:
    enabled: true
    priority: high           # low / default / high
    channel: openclaw_main   # 通知渠道

Android 通知支持：

• 自定义通知音
• 通知分组和折叠
• 快捷回复（直接在通知栏回复 Agent）
• 持久通知（Persistent Notification）

语音交互

node:
  capabilities:
    audio: true
talk:
  mode: push_to_talk         # 或 always_listening
  vad:
    engine: silero

摄像头

node:
  capabilities:
    camera: true
camera:
  mode: snapshot
  use_front: false            # false=后摄, true=前摄
  resolution: 1280x720

位置服务

node:
  capabilities:
    location: true
location:
  source: fused
  update_interval: 120

电池优化

关键步骤

Android 手机的电池优化是使用 OpenClaw 节点最大的挑战。请务必完成以下配置，否则 App 可能在后台被系统杀掉。

通用设置

1. 打开「设置 → 电池 → 电池优化」
2. 找到 OpenClaw，选择「不优化」
3. 打开「设置 → 应用 → OpenClaw → 电池 → 不受限制」

开启前台服务

# App 内配置
android:
  foreground_service: true    # 显示常驻通知，防止被杀
  wake_lock: partial          # 保持 CPU 唤醒

厂商特殊配置

🇨🇳 国内安卓手机电池管理注意事项

国内手机厂商普遍有激进的后台管理策略，必须针对性配置。

小米 / Redmi (MIUI / HyperOS)

1. 设置 → 应用设置 → 应用管理 → OpenClaw
2. 省电策略 → 选择「无限制」
3. 自启动管理 → 允许 OpenClaw 自启动
4. 锁定 App：在最近任务中下拉 OpenClaw 卡片，点击🔒锁定

OPPO / realme (ColorOS)

1. 设置 → 电池 → 更多电池设置
2. 关闭「睡眠待机优化」
3. 设置 → 应用管理 → OpenClaw → 耗电管理 → 允许后台运行
4. 开启「允许自启动」

Vivo / iQOO (OriginOS / Funtouch OS)

1. 设置 → 电池 → 后台高耗电 → 允许 OpenClaw
2. i管家 → 应用管理 → 权限管理 → 自启动 → 允许 OpenClaw
3. 锁定 App：最近任务中下拉锁定

华为 / 荣耀 (HarmonyOS / EMUI)

1. 设置 → 电池 → 启动管理 → OpenClaw → 手动管理
2. 允许：自启动 ✅、关联启动 ✅、后台活动 ✅
3. 设置 → 应用 → 应用启动管理 → 关闭 OpenClaw 的自动管理

Samsung (One UI)

1. 设置 → 电池和设备维护 → 电池
2. 后台使用限制 → 将 OpenClaw 从「深度休眠应用」移除
3. 添加到「永不休眠应用」列表

完整配置示例

日常模式

node:
  type: mobile
  capabilities:
    audio: true
    camera: true
    location: true
    notifications: true
android:
  foreground_service: true
  wake_lock: partial
power:
  mode: balanced
location:
  update_interval: 300

省电模式

node:
  type: mobile
  capabilities:
    audio: false
    camera: false
    location: false
    notifications: true
android:
  foreground_service: false
power:
  mode: low_power

常用 ADB 调试命令

# 查看 OpenClaw 进程状态
adb shell dumpsys activity processes | grep openclaw

# 查看电池优化状态
adb shell dumpsys deviceidle whitelist

# 手动添加白名单
adb shell dumpsys deviceidle whitelist +com.openclaw.node

# 查看应用日志
adb logcat -s OpenClaw

故障排查

问题	解决方案
后台被杀	完成厂商特殊配置 + 开启前台服务
通知收不到	检查通知权限，确认通知渠道未静音
配对失败	确认网络连通性，检查防火墙
GPS 不准	开启「高精度定位」模式
耗电过快	切换省电模式，关闭不需要的能力
APK 安装失败	开启「允许安装未知来源」