SuperAPI AI 工具集

adb-claw

智能体与模型

查看项目

更新于 11-02 00:28

技能介绍

ADB Claw 是一个面向 Android 设备的命令行控制工具,强调为 AI 代理提供“眼睛、手和耳朵”:观察屏幕、执行交互、监听 UI 文本与音频。其所有命令返回结构化 JSON({ok, command, data, error, duration_ms}),便于程序化处理。

主要能力:

  • 观察与截图:observe 命令一次调用返回截图(base64 PNG)和带索引的 UI 元素树(文本/id/边界/中心坐标);screenshot 可保存到文件或缩放。
  • 交互:支持按索引、资源 ID、文本或坐标点击;长按;滑动;智能滚动(自动计算坐标,支持方向、页数和指定元素内滚动);输入 ASCII 文本;按系统键(HOME/BACK/ENTER 等);清空输入框;通过 open 命令打开 URI/深链接,可利用 URL 参数传递中文/日文/韩文,绕过 adb input text 的 CJK 限制。
  • 等待与验证:wait 命令阻塞等待 UI 元素或 Activity 出现/消失,替代轮询。
  • 屏幕管理:查询状态、唤醒/关闭、解锁、旋转。
  • 应用管理:列出、启动、停止、安装、卸载、清除数据。
  • 监控:monitor 命令连接 Android 无障碍框架,持续读取 UI 文本,在视频播放和直播场景下仍可用(uiautomator dump 可能挂起),支持有界模式和流式 JSON 行输出。
  • 音频捕获:audio capture 通过 REMOTE_SUBMIX 捕获系统音频(Android 11+),输出 WAV(16kHz 单声道 16-bit PCM),可管道到 ASR 工具;捕获期间设备扬声器静音。
  • 直播购物车:live cart 命令针对抖音直播,抓取讲解中商品和购物车前 N 个商品信息(标题、价格、销量、店铺、标签等)。
  • shell:执行原始 shell 命令。

使用方式:需安装 adb(Android SDK Platform-Tools)并在 Android 设备上启用 USB 调试、通过 USB 连接。可通过 Claude Code 插件(claude plugin add llm-net/adb-claw)或 OpenClaw(claw install adb-claw)安装,插件会自动下载 adb-claw 二进制(位于 ${CLAUDE_PLUGIN_ROOT}/bin/adb-claw)。安装后可用自然语言触发,也可直接使用 CLI。核心循环为 observe → 决策 → 操作 → observe。常用命令示例:adb-claw observe --width 540、adb-claw tap --index 3、adb-claw open 'snssdk1128://search/result?keyword=猫咪'、adb-claw wait --text "综合" --timeout 5000。提供 app profiles(如抖音、美团)的 Markdown 知识库,包含深链接、布局和已知问题,放在 skills/apps/ 目录。

适用场景:Android 移动应用 UI 自动化测试、AI 代理操控手机、直播聊天文本监控、系统音频转写、抖音直播购物车数据抓取等。

限制:type 仅支持 ASCII 文本,CJK/emoji 需用 deep link;monitor 和 audio capture 首次使用时推送约 7KB 的临时 DEX 助手,监控结束自动退出;audio capture 需要 Android 11+ 且会静音扬声器;live cart 仅适用于抖音直播;需设备启用 USB 调试并连接。具体收费、价格、平台兼容性细节暂未提供。