核心用法
ADB Claw 是一款基于 ADB 协议的 Android 设备命令行控制工具，封装了 adbclaw CLI 以简化设备交互。核心能力围绕六大场景：屏幕观测（observe/screenshot）、触控操作（tap/swipe/long-press）、文本输入（type）、系统按键（key）、应用管理（app）及设备信息查询（device/ui）。
推荐工作流：始终先执行 adbclaw observe 获取当前屏幕截图与 UI 元素树（含索引、文本、坐标），再基于 --index 进行精准点击，操作后再次 observe 验证状态。这种"观测-操作-验证"循环是稳定自动化的关键。对于复杂手势，需根据 device info 输出的屏幕尺寸计算相对坐标，区分手机（短边<1200px）与平板/折叠屏（短边≥1200px）的布局差异。
显著优点
1. 结构化输出：所有命令返回统一 JSON 格式，包含执行状态、耗时、时间戳及结构化数据，便于程序化解析与日志追踪。
2. 元素级精准控制：observe 命令同时输出 base64 截图与索引化的 UI 元素树，支持 --index 稳定定位，比坐标点击更抗屏幕尺寸变化。
3. 应用深度集成：内置 Douyin 等热门应用的 deep link 方案与已知布局档案，可将多步 UI 操作压缩为单条 intent 调用，规避中文输入限制。
4. 轻量依赖：仅依赖 adb 与 adbclaw 两个二进制文件，通过 Homebrew 与 curl 脚本即可完成安装，无复杂 SDK 配置。
潜在缺点与局限性
1. ASCII 输入限制：type 命令仅支持 ASCII 字符，中文/日文/韩文及 emoji 需借助 deep link 或剪贴板变通，增加集成复杂度。
2. 动态 UI 脆弱性：视频播放等动画场景下 UI dump 可能失败，需人工介入暂停后再操作；部分应用存在反自动化检测机制。
3. USB 调试前置要求：必须开启开发者选项与 USB 调试，且通过 USB 连接，无线 ADB 需额外配置未在文档中详述。
4. 设备生态局限：仅支持 Android，iOS 与桌面端需切换至其他工具（如 peekaboo），跨平台场景需维护多套方案。
适合人群
- 移动端 QA 工程师：进行自动化 UI 测试、回归验证与截图比对
- Android 开发者：快速调试应用启动、权限处理及跨设备适配
- 运维/技术支持：远程批量管理测试机群，执行标准操作流程
- 自动化脚本编写者：构建基于 JSON 输出的 CI/CD 集成或 RPA 流程
常规风险
- 权限风险：USB 调试开启后设备暴露于 ADB 攻击面，连接不可信主机可能导致未授权访问
- 误操作风险：
app stop强制终止应用可能导致数据丢失；坐标/索引误触可能触发意外功能 - 兼容风险：不同 Android 版本、厂商定制 UI（如 MIUI、ColorOS）的元素层级差异可能导致定位失败
- 法律合规风险：自动化操控社交媒体应用（如抖音）可能违反平台服务条款，需评估业务合规性