Android 控制技能

通过 Clawdbot 直接控制 Android 手机，使用内置的 Android CLI 工具。
该技能始终优先尝试 普通（非 root） 命令；若失败，则在可用时自动回退至 root 模式（su） 重试。

功能

• 通过 uiautomator dump 获取 UI 层级快照
• 使用 screencap 截取屏幕图像
• 通过 input 模拟点击、滑动及输入事件
• 使用 am start 启动应用
• 当非 root 命令失败时自动回退至 root 模式重试

配置

大多数 Android ROM 均已预装 uiautomator、input、screencap 和 am 工具。

如需启用 root 回退机制，请安装 Magisk，或执行以下命令：

su

使用方法

获取 UI 快照（uiautomator dump）

# 尝试非 root 模式
uiautomator dump /sdcard/ui_dump.xml 2>/dev/null 
  && cat /sdcard/ui_dump.xml 
  || (
    # 回退至 root 模式
    su -c "uiautomator dump /sdcard/ui_dump.xml" && su -c "cat /sdcard/ui_dump.xml"
  )

截取屏幕（PNG 格式，base64 编码）

TMP="/sdcard/ai_screen.png"

# 尝试非 root 模式
screencap -p "$TMP" 2>/dev/null 
  && base64 "$TMP" 
  || (
    # 回退至 root 模式
    su -c "screencap -p $TMP"
    su -c "base64 $TMP"
  )

点击屏幕

# 示例：在坐标 (540, 1600) 处执行点击

input tap 540 1600 2>/dev/null 
  || su -c "input tap 540 1600"

滑动屏幕

# 示例：从 (500, 1600) 滑动至 (500, 600)，持续时间为 300 毫秒

input swipe 500 1600 500 600 300 2>/dev/null 
  || su -c "input swipe 500 1600 500 600 300"

启动应用

# 示例：启动 Android 设置应用

am start -n com.android.settings/.Settings 2>/dev/null 
  || su -c "am start -n com.android.settings/.Settings"

发送文本输入

# 示例：发送文本 "Hello"

input text "Hello" 2>/dev/null 
  || su -c "input text 'Hello'"