v1.8.0 — IPC Optimization + Feedback Loop

What's New

🚀 IPC Optimization (biggest change)

• findByText / findById now use Android system APIs instead of manual tree traversal
• ~50x faster on screens with 400+ nodes (3s+ → ~50ms)
• findByDesc uses depth-limited search (max depth 15)

🔄 Act → Observe → Learn

• /screen/fast — lightweight screen state (package + top texts), max 50 nodes, 2s timeout
• /click, /tap, /swipe support "verify": true — returns post-action screen state
• /screen/state now includes foregroundPackage

📱 App Control

• POST /app/kill — kill misbehaving apps (killBackgroundProcesses + force home)
• POST /app/force-home — HOME action + post-state verification

🔒 Session & Permission Gate

• Token-based trust system with X-Agent-Name / X-Session-Id headers
• On-device permission dialog for untrusted agents (30s timeout)
• Session tracking: 5-minute sessions with idle timeout

🔄 OTA Self-Update

• POST /file/upload — raw stream upload (no size limit)
• POST /install — trigger APK install from device storage
• UpdateReceiver auto-restarts service after update

📊 37+ Endpoints

Clipboard, camera, volume, location, files, contacts, SMS, WiFi, battery, vibrate, TTS, audio recording, batch operations, flow automation, and more.

🌐 GitHub Pages

Landing page: https://claw-use.github.io/claw-use-android/

---

Full Changelog: v1.2.0...v1.8.0

v1.7.0 — Full Phone I/O

🎯 Complete Phone I/O Coverage

37 endpoints. Every phone input and output — accessible over HTTP. No root. No ADB. No PC.

New in v1.7.0 (12 new endpoints)

📋 Clipboard — GET/POST /clipboard — read and write clipboard
📷 Camera — POST /camera — capture photo (front/back, quality, scale)
🔊 Volume — GET/POST /volume — read/set all audio streams
🔋 Battery — GET /battery — level, charging, temperature, health
📡 WiFi — GET /wifi — SSID, IP, signal strength, frequency
📍 Location — GET /location — GPS/network with auto-fallback
📳 Vibrate — POST /vibrate — one-shot or pattern
👥 Contacts — GET /contacts — search and list phone contacts
💬 SMS — GET/POST /sms — read inbox/sent, send messages
📁 File — GET/POST/DELETE /file + GET /file/list — full filesystem
🎤 Audio Record — POST /audio/record — microphone recording
⚡ Batch — POST /batch — multiple operations in one request

Bug Fixes

• Click exact matching: /click now matches exact text first, falls back to substring. No more 'eau' matching 'nouveau'.
• Blind PIN unlock: Coordinate-based PIN input when a11y tree is empty (OPPO/ColorOS)

CLI

New commands: cua clipboard, cua camera, cua volume, cua battery, cua wifi, cua location, cua vibrate, cua contacts, cua sms, cua file

Full Endpoint List (37)

Perception: /screen, /screenshot, /notifications, /screen/state, /info, /status
Action: /tap, /click, /longpress, /swipe, /scroll, /type, /global, /launch, /intent
Audio: /tts, /tts/voices, /audio/record
Device I/O: /clipboard, /camera, /volume, /battery, /wifi, /location, /vibrate, /contacts, /sms, /file, /file/list
Batch & Flow: /batch, /flow
Security: /screen/wake, /screen/lock, /screen/unlock, /config, /ping

v1.2.0 — Screenshot + Notifications + Intent + TTS

What's New

25 HTTP endpoints for full phone control. No ADB, no root, no PC.

New Endpoints

• GET /screenshot — real screen capture via AccessibilityService (base64 JPEG, configurable quality & resolution)
• GET /notifications — list all phone notifications with title, text, actions
• POST /notifications/click|dismiss|action — interact with notifications
• POST /intent — fire any Android Intent (call, SMS, URL, share, deep links)
• POST /tts — speak text through the phone speaker (multi-language)
• GET /tts/voices — list available TTS voices

Self-Update Loop

The app now includes UpdateReceiver — after installing a new version, BridgeService auto-restarts. An AI agent can build, send, install, and regain control without any human intervention.

Install

1. Download claw-use-android.apk below
2. Install on any Android 7.0+ device
3. Enable Accessibility Service in Settings
4. curl http://<phone-ip>:7333/ping

Requirements

• Android 7.0+ (API 24) for core features
• Android 11+ (API 30) for /screenshot
• No root. No ADB. No PC.