Aplikasi Android

Aplikasi Android belum dirilis secara publik. Kode sumber tersedia di repositori OpenClaw di bawah apps/android. Anda dapat membangunnya sendiri menggunakan Java 17 dan Android SDK (./gradlew :app:assemblePlayDebug). Lihat apps/android/README.md untuk instruksi build.

Snapshot dukungan

Peran: aplikasi node pendamping (Android tidak meng-host Gateway).
Gateway diperlukan: ya (jalankan di macOS, Linux, atau Windows melalui WSL2).
Instal: Memulai + Pairing.
Gateway: Runbook + Konfigurasi.
- Protokol: Protokol Gateway (node + control plane).

Kontrol sistem

Kontrol sistem (launchd/systemd) berada di host Gateway. Lihat Gateway.

Runbook koneksi

Aplikasi node Android ⇄ (mDNS/NSD + WebSocket) ⇄ Gateway Android terhubung langsung ke WebSocket Gateway dan menggunakan pairing perangkat (role: node). Untuk Tailscale atau host publik, Android memerlukan endpoint aman:

Disarankan: Tailscale Serve / Funnel dengan https://<magicdns> / wss://<magicdns>
Juga didukung: URL Gateway wss:// lain dengan endpoint TLS sungguhan
Cleartext ws:// tetap didukung pada alamat LAN privat / host .local, ditambah localhost, 127.0.0.1, dan bridge emulator Android (10.0.2.2)

Prasyarat

Anda dapat menjalankan Gateway di mesin “master”.
Perangkat/emulator Android dapat menjangkau WebSocket gateway:
- LAN yang sama dengan mDNS/NSD, atau
- Tailnet Tailscale yang sama menggunakan Wide-Area Bonjour / unicast DNS-SD (lihat di bawah), atau
- Host/port gateway manual (fallback)
Pairing seluler tailnet/publik tidak menggunakan endpoint IP tailnet mentah ws://. Gunakan Tailscale Serve atau URL wss:// lain sebagai gantinya.
Anda dapat menjalankan CLI (openclaw) di mesin gateway (atau melalui SSH).

1) Mulai Gateway

openclaw gateway --port 18789 --verbose

Konfirmasi di log bahwa Anda melihat sesuatu seperti:

listening on ws://0.0.0.0:18789

Untuk akses Android jarak jauh melalui Tailscale, lebih baik gunakan Serve/Funnel daripada bind tailnet mentah:

openclaw gateway --tailscale serve

Ini memberi Android endpoint wss:// / https:// yang aman. Setup gateway.bind: "tailnet" biasa tidak cukup untuk pairing Android jarak jauh pertama kali kecuali Anda juga menghentikan TLS secara terpisah.

2) Verifikasi discovery (opsional)

Dari mesin gateway:

dns-sd -B _openclaw-gw._tcp local.

Catatan debugging lainnya: Bonjour. Jika Anda juga mengonfigurasi domain discovery wide-area, bandingkan dengan:

openclaw gateway discover --json

Itu menampilkan local. plus domain wide-area yang dikonfigurasi dalam satu pass dan menggunakan endpoint layanan yang di-resolve, bukan hanya petunjuk TXT.

Discovery tailnet (Wina ⇄ London) melalui unicast DNS-SD

Discovery NSD/mDNS Android tidak akan melintasi jaringan. Jika node Android dan gateway berada di jaringan berbeda tetapi terhubung melalui Tailscale, gunakan Wide-Area Bonjour / unicast DNS-SD sebagai gantinya. Discovery saja tidak cukup untuk pairing Android tailnet/publik. Rute yang ditemukan tetap memerlukan endpoint aman (wss:// atau Tailscale Serve):

Siapkan zona DNS-SD (contoh openclaw.internal.) di host gateway dan publikasikan record _openclaw-gw._tcp.
Konfigurasikan split DNS Tailscale untuk domain pilihan Anda yang mengarah ke server DNS tersebut.

Detail dan contoh konfigurasi CoreDNS: Bonjour.

3) Hubungkan dari Android

Di aplikasi Android:

Aplikasi menjaga koneksi gateway tetap aktif melalui foreground service (notifikasi persisten).
Buka tab Connect.
Gunakan mode Setup Code atau Manual.
Jika discovery diblokir, gunakan host/port manual di Advanced controls. Untuk host LAN privat, ws:// tetap berfungsi. Untuk host Tailscale/publik, aktifkan TLS dan gunakan endpoint wss:// / Tailscale Serve.

Setelah pairing pertama berhasil, Android otomatis terhubung kembali saat diluncurkan:

Endpoint manual (jika diaktifkan), jika tidak
Gateway terakhir yang ditemukan (best-effort).

Beacon presence alive

Setelah sesi node terautentikasi terhubung, dan saat aplikasi berpindah ke latar belakang sementara foreground service masih terhubung, Android memanggil node.event dengan event: "node.presence.alive". Gateway mencatat ini sebagai lastSeenAtMs/lastSeenReason pada metadata node/perangkat yang dipairing hanya setelah identitas perangkat node terautentikasi diketahui. Aplikasi menghitung beacon sebagai berhasil dicatat hanya ketika respons gateway menyertakan handled: true. Gateway lama mungkin mengakui node.event dengan { "ok": true }; respons itu kompatibel tetapi tidak dihitung sebagai pembaruan last-seen yang tahan lama.

4) Setujui pairing (CLI)

Di mesin gateway:

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

Detail pairing: Pairing. Opsional: jika node Android selalu terhubung dari subnet yang dikontrol ketat, Anda dapat ikut serta dalam persetujuan otomatis node pertama kali dengan CIDR eksplisit atau IP persis:

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

Ini dinonaktifkan secara default. Ini hanya berlaku untuk pairing role: node baru tanpa scope yang diminta. Pairing operator/browser serta perubahan peran, scope, metadata, atau public-key apa pun tetap memerlukan persetujuan manual.

5) Verifikasi node terhubung

Melalui status node:
```
openclaw nodes status
```

Melalui Gateway:

openclaw gateway call node.list --params "{}"

6) Chat + riwayat

Tab Chat Android mendukung pemilihan sesi (default main, plus sesi lain yang sudah ada):

Riwayat: chat.history (dinormalisasi untuk tampilan; tag direktif inline dihapus dari teks yang terlihat, payload XML tool-call teks biasa (termasuk <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls>, dan blok tool-call yang terpotong) serta token kontrol model ASCII/full-width yang bocor dihapus, baris asisten token senyap murni seperti persis NO_REPLY / no_reply dihilangkan, dan baris yang terlalu besar dapat diganti dengan placeholder)
Kirim: chat.send
Pembaruan push (best-effort): chat.subscribe → event:"chat"

7) Canvas + kamera

Host Canvas Gateway (direkomendasikan untuk konten web)

Jika Anda ingin node menampilkan HTML/CSS/JS nyata yang dapat diedit agent di disk, arahkan node ke host canvas Gateway.

Node memuat canvas dari server HTTP Gateway (port yang sama dengan gateway.port, default 18789).

Buat ~/.openclaw/workspace/canvas/index.html di host gateway.
Arahkan node ke sana (LAN):

openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18789/__openclaw__/canvas/"}'

Tailnet (opsional): jika kedua perangkat berada di Tailscale, gunakan nama MagicDNS atau IP tailnet sebagai ganti .local, mis. http://<gateway-magicdns>:18789/__openclaw__/canvas/. Server ini menyuntikkan klien live-reload ke HTML dan memuat ulang saat file berubah. Host A2UI berada di http://<gateway-host>:18789/__openclaw__/a2ui/. Perintah canvas (hanya foreground):

canvas.eval, canvas.snapshot, canvas.navigate (gunakan {"url":""} atau {"url":"/"} untuk kembali ke scaffold default). canvas.snapshot mengembalikan { format, base64 } (default format="jpeg").
A2UI: canvas.a2ui.push, canvas.a2ui.reset (alias legacy canvas.a2ui.pushJSONL)

Perintah kamera (hanya foreground; dibatasi izin):

camera.snap (jpg)
camera.clip (mp4)

Lihat Node kamera untuk parameter dan helper CLI.

8) Suara + permukaan perintah Android yang diperluas

Tab Voice: Android memiliki dua mode capture eksplisit. Mic adalah sesi tab Voice manual yang mengirim setiap jeda sebagai giliran chat dan berhenti saat aplikasi meninggalkan foreground atau pengguna meninggalkan tab Voice. Talk adalah Talk Mode berkelanjutan dan terus mendengarkan sampai dimatikan atau node terputus.
Talk Mode mempromosikan foreground service yang ada dari dataSync ke dataSync|microphone sebelum capture dimulai, lalu menurunkannya saat Talk Mode berhenti. Android 14+ memerlukan deklarasi FOREGROUND_SERVICE_MICROPHONE, pemberian runtime RECORD_AUDIO, dan tipe layanan mikrofon saat runtime.
Balasan lisan menggunakan talk.speak melalui penyedia Talk gateway yang dikonfigurasi. TTS sistem lokal hanya digunakan ketika talk.speak tidak tersedia.
Voice wake tetap dinonaktifkan di UX/runtime Android.
Keluarga perintah Android tambahan (ketersediaan bergantung pada perangkat + izin):
- device.status, device.info, device.permissions, device.health
- notifications.list, notifications.actions (lihat Penerusan notifikasi di bawah)
- photos.latest
- contacts.search, contacts.add
- calendar.events, calendar.add
- callLog.search
- sms.search
- motion.activity, motion.pedometer

Entry point asisten

Android mendukung peluncuran OpenClaw dari pemicu asisten sistem (Google Assistant). Saat dikonfigurasi, menahan tombol home atau mengatakan “Hey Google, ask OpenClaw…” membuka aplikasi dan meneruskan prompt ke composer chat. Ini menggunakan metadata App Actions Android yang dideklarasikan dalam manifest aplikasi. Tidak diperlukan konfigurasi tambahan di sisi gateway — intent asisten ditangani sepenuhnya oleh aplikasi Android dan diteruskan sebagai pesan chat normal.

Ketersediaan App Actions bergantung pada perangkat, versi Google Play Services, dan apakah pengguna telah menetapkan OpenClaw sebagai aplikasi asisten default.

Penerusan notifikasi

Android dapat meneruskan notifikasi perangkat ke gateway sebagai event. Beberapa kontrol memungkinkan Anda membatasi notifikasi mana yang diteruskan dan kapan.

Key	Tipe	Deskripsi
`notifications.allowPackages`	string[]	Hanya teruskan notifikasi dari nama package ini. Jika disetel, semua package lain diabaikan.
`notifications.denyPackages`	string[]	Jangan pernah teruskan notifikasi dari nama package ini. Diterapkan setelah `allowPackages`.
`notifications.quietHours.start`	string (HH:mm)	Awal jendela jam tenang (waktu perangkat lokal). Notifikasi ditekan selama jendela ini.
`notifications.quietHours.end`	string (HH:mm)	Akhir jendela jam tenang.
`notifications.rateLimit`	number	Jumlah maksimum notifikasi yang diteruskan per package per menit. Notifikasi berlebih dibuang.

Pemilih notifikasi juga menggunakan perilaku yang lebih aman untuk event notifikasi yang diteruskan, mencegah penerusan notifikasi sistem sensitif secara tidak sengaja. Contoh konfigurasi:

{
  notifications: {
    allowPackages: ["com.slack", "com.whatsapp"],
    denyPackages: ["com.android.systemui"],
    quietHours: {
      start: "22:00",
      end: "07:00",
    },
    rateLimit: 5,
  },
}

Penerusan notifikasi memerlukan izin Notification Listener Android. Aplikasi meminta izin ini saat setup.

Platforms overview

macOS companion app

Snapshot dukungan

Kontrol sistem

Runbook koneksi

Prasyarat

1) Mulai Gateway

2) Verifikasi discovery (opsional)

Discovery tailnet (Wina ⇄ London) melalui unicast DNS-SD

3) Hubungkan dari Android

Beacon presence alive

4) Setujui pairing (CLI)

5) Verifikasi node terhubung

6) Chat + riwayat

7) Canvas + kamera

Host Canvas Gateway (direkomendasikan untuk konten web)

8) Suara + permukaan perintah Android yang diperluas

Entry point asisten

Penerusan notifikasi

Terkait

Platforms overview

macOS companion app

Documentation Index

​Snapshot dukungan

​Kontrol sistem

​Runbook koneksi

​Prasyarat

​1) Mulai Gateway

​2) Verifikasi discovery (opsional)

​Discovery tailnet (Wina ⇄ London) melalui unicast DNS-SD

​3) Hubungkan dari Android

​Beacon presence alive

​4) Setujui pairing (CLI)

​5) Verifikasi node terhubung

​6) Chat + riwayat

​7) Canvas + kamera

​Host Canvas Gateway (direkomendasikan untuk konten web)

​8) Suara + permukaan perintah Android yang diperluas

​Entry point asisten

​Penerusan notifikasi

​Terkait

Snapshot dukungan

Kontrol sistem

Runbook koneksi

Prasyarat

1) Mulai Gateway

2) Verifikasi discovery (opsional)

Discovery tailnet (Wina ⇄ London) melalui unicast DNS-SD

3) Hubungkan dari Android

Beacon presence alive

4) Setujui pairing (CLI)

5) Verifikasi node terhubung

6) Chat + riwayat

7) Canvas + kamera

Host Canvas Gateway (direkomendasikan untuk konten web)

8) Suara + permukaan perintah Android yang diperluas

Entry point asisten

Penerusan notifikasi

Terkait