App ng Android (Node)¶

Snapshot ng Suporta¶

• Role: companion node app (hindi nagho-host ng Gateway ang Android).
• Kailangan ang Gateway: oo (patakbuhin sa macOS, Linux, o Windows via WSL2).
• Install: Pagsisimula + Pairing.
• Gateway: Runbook + Konpigurasyon.
• Mga protocol: Gateway protocol (nodes + control plane).

Kontrol ng Sistema¶

Ang kontrol ng sistema (launchd/systemd) ay nasa Gateway host. Tingnan ang Gateway.

Runbook ng Koneksyon¶

App ng Android node ⇄ (mDNS/NSD + WebSocket) ⇄ Gateway

Direktang kumokonekta ang Android sa Gateway WebSocket (default ws://<host>:18789) at gumagamit ng pairing na pagmamay-ari ng Gateway.

Mga paunang kinakailangan¶

• Kaya mong patakbuhin ang Gateway sa “master” machine.
• Naabot ng Android device/emulator ang gateway WebSocket:
• Parehong LAN na may mDNS/NSD, o
• Parehong Tailscale tailnet gamit ang Wide-Area Bonjour / unicast DNS-SD (tingnan sa ibaba), o
• Manual na gateway host/port (fallback)
• Kaya mong patakbuhin ang CLI (openclaw) sa gateway machine (o via SSH).

1. Simulan ang Gateway¶

openclaw gateway --port 18789 --verbose

Kumpirmahin sa logs na may makikita kang ganito:

• listening on ws://0.0.0.0:18789

Para sa tailnet-only setups (inirerekomenda para sa Vienna ⇄ London), i-bind ang gateway sa tailnet IP:

• Itakda ang gateway.bind: "tailnet" sa ~/.openclaw/openclaw.json sa host ng Gateway.
• I-restart ang Gateway / macOS menubar app.

2. I-verify ang discovery (opsyonal)¶

Mula sa gateway machine:

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

Karagdagang tala sa pag-debug: Bonjour.

Pagtuklas ng Tailnet (Vienna ⇄ London) sa pamamagitan ng unicast DNS-SD¶

Hindi tatawid ng mga network ang Android NSD/mDNS discovery. Kung ang iyong Android node at ang gateway ay nasa magkaibang network ngunit konektado sa pamamagitan ng Tailscale, gumamit ng Wide‑Area Bonjour / unicast DNS‑SD sa halip:

1. Mag-set up ng DNS-SD zone (halimbawa openclaw.internal.) sa host ng Gateway at i-publish ang mga record na _openclaw-gw._tcp.
2. I-configure ang Tailscale split DNS para sa napiling domain na tumuturo sa DNS server na iyon.

Mga detalye at halimbawa ng CoreDNS config: Bonjour.

3. Kumonekta mula sa Android¶

Sa Android app:

• Pinananatiling buhay ng app ang koneksyon sa gateway sa pamamagitan ng foreground service (persistent notification).
• Buksan ang Settings.
• Sa ilalim ng Discovered Gateways, piliin ang iyong gateway at pindutin ang Connect.
• Kung naka-block ang mDNS, gamitin ang Advanced → Manual Gateway (host + port) at Connect (Manual).

Pagkatapos ng unang matagumpay na pairing, awtomatikong magre-reconnect ang Android sa launch:

• Manual endpoint (kung naka-enable), kung hindi
• Ang huling nadiskubreng gateway (best-effort).

4. Aprubahan ang pairing (CLI)¶

Sa gateway machine:

openclaw nodes pending
openclaw nodes approve <requestId>

Mga detalye ng pairing: Gateway pairing.

5. I-verify na nakakonekta ang node¶

• Via status ng nodes:

bash openclaw nodes status

• Sa pamamagitan ng Gateway:

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

6. Chat + history¶

Ginagamit ng Chat sheet ng Android node ang primary session key ng gateway (main), kaya ibinabahagi ang history at mga reply sa WebChat at iba pang client:

• Kasaysayan: chat.history
• Send: chat.send
• Push updates (best-effort): chat.subscribe → event:"chat"

7. Canvas + camera¶

Gateway Canvas Host (inirerekomenda para sa web content)¶

Kung gusto mong magpakita ang node ng totoong HTML/CSS/JS na puwedeng i-edit ng agent sa disk, ituro ang node sa Gateway canvas host.

Tandaan: gumagamit ang mga node ng standalone canvas host sa canvasHost.port (default 18793).

1. Gumawa ng ~/.openclaw/workspace/canvas/index.html sa host ng Gateway.

2. I-navigate ang node dito (LAN):

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

Tailnet (optional): if both devices are on Tailscale, use a MagicDNS name or tailnet IP instead of .local, e.g. http://<gateway-magicdns>:18793/__openclaw__/canvas/.

This server injects a live-reload client into HTML and reloads on file changes. The A2UI host lives at http://<gateway-host>:18793/__openclaw__/a2ui/.

Mga command ng Canvas (foreground lamang):

• canvas.eval, canvas.snapshot, canvas.navigate (use {"url":""} or {"url":"/"} to return to the default scaffold). Ang canvas.snapshot ay nagbabalik ng { format, base64 } (default format="jpeg").
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL legacy alias)

Mga command ng camera (foreground lamang; may permission gate):

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

Tingnan ang Camera node para sa mga parameter at CLI helpers.