You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gpt-pilot/apps/android
Peter Steinberger 92cc7a841c refactor: centralize main session key normalization in apps 10 months ago
..
app refactor: centralize main session key normalization in apps 10 months ago
gradle/wrapper chore(android): update toolchain and deps 11 months ago
.gitignore feat(android): add Compose node app (bridge+canvas+chat+camera) 11 months ago
README.md chore: rename project to clawdbot 11 months ago
build.gradle.kts chore(android): update toolchain and deps 11 months ago
gradle.properties Android: add Voice Wake (foreground/always) 11 months ago
gradlew Android: add Voice Wake (foreground/always) 11 months ago
gradlew.bat Android: add Voice Wake (foreground/always) 11 months ago
settings.gradle.kts chore: rename project to clawdbot 11 months ago

README.md

Clawdbot Node (Android) (internal)

Modern Android node app: connects to the Gateway-owned bridge (_clawdbot-bridge._tcp) over TCP and exposes Canvas + Chat + Camera.

Notes:

  • The node keeps the connection alive via a foreground service (persistent notification with a Disconnect action).
  • Chat always uses the shared session key main (same session across iOS/macOS/WebChat/Android).
  • Supports modern Android only (minSdk 31, Kotlin + Jetpack Compose).

Open in Android Studio

  • Open the folder apps/android.

Build / Run

cd apps/android
./gradlew :app:assembleDebug
./gradlew :app:installDebug
./gradlew :app:testDebugUnitTest

gradlew auto-detects the Android SDK at ~/Library/Android/sdk (macOS default) if ANDROID_SDK_ROOT / ANDROID_HOME are unset.

Connect / Pair

  1. Start the gateway (on your “master” machine):
pnpm clawdbot gateway --port 18789 --verbose
  1. In the Android app:
  • Open Settings
  • Either select a discovered bridge under Discovered Bridges, or use Advanced → Manual Bridge (host + port).
  1. Approve pairing (on the gateway machine):
clawdbot nodes pending
clawdbot nodes approve <requestId>

More details: docs/android/connect.md.

Permissions

  • Discovery:
    • Android 13+ (API 33+): NEARBY_WIFI_DEVICES
    • Android 12 and below: ACCESS_FINE_LOCATION (required for NSD scanning)
  • Foreground service notification (Android 13+): POST_NOTIFICATIONS
  • Camera:
    • CAMERA for camera.snap and camera.clip
    • RECORD_AUDIO for camera.clip when includeAudio=true