​

Android-App (Node)

Hinweis: Die Android-App wurde noch nicht öffentlich veröffentlicht. Der Quellcode ist im OpenClaw-Repository unter apps/android verfügbar. Sie können sie selbst mit Java 17 und dem Android SDK bauen (./gradlew :app:assemblePlayDebug). Siehe apps/android/README.md für Build-Anweisungen.

​

Support-Überblick

• Rolle: begleitende Node-App (Android hostet das Gateway nicht).
• Gateway erforderlich: ja (führen Sie es auf macOS, Linux oder Windows über WSL2 aus).
• Installation: Getting Started + Pairing.
• Gateway: Runbook + Konfiguration.
  • Protokolle: Gateway-Protokoll (Nodes + Control Plane).

​

Systemsteuerung

​

Verbindungs-Runbook

• Bevorzugt: Tailscale Serve / Funnel mit https://<magicdns> / wss://<magicdns>
• Ebenfalls unterstützt: jede andere wss://-Gateway-URL mit einem echten TLS-Endpunkt
• Klartext-ws:// wird weiterhin auf privaten LAN-Adressen / .local-Hosts sowie auf localhost, 127.0.0.1 und der Android-Emulator-Bridge (10.0.2.2) unterstützt

​

Voraussetzungen

• Sie können das Gateway auf dem „Master“-Rechner ausführen.
• Android-Gerät/Emulator kann den Gateway-WebSocket erreichen:
  • Gleiches LAN mit mDNS/NSD, oder
  • gleiches Tailscale-Tailnet mit Wide-Area Bonjour / unicast DNS-SD (siehe unten), oder
  • manueller Gateway-Host/Port (Fallback)
• Mobiles Pairing über Tailnet/öffentlich verwendet keine rohen Tailnet-IP-Endpunkte mit ws://. Verwenden Sie stattdessen Tailscale Serve oder eine andere wss://-URL.
• Sie können die CLI (openclaw) auf dem Gateway-Rechner ausführen (oder per SSH).

​

1) Das Gateway starten

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2) Discovery verifizieren (optional)

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

openclaw gateway discover --json

​

Tailnet-Discovery (Wien ⇄ London) über unicast DNS-SD

1. Richten Sie eine DNS-SD-Zone (Beispiel openclaw.internal.) auf dem Gateway-Host ein und veröffentlichen Sie _openclaw-gw._tcp-Einträge.
2. Konfigurieren Sie Tailscale Split DNS für Ihre gewählte Domain, die auf diesen DNS-Server zeigt.

​

3) Von Android aus verbinden

• Die App hält ihre Gateway-Verbindung über einen Foreground Service (persistente Benachrichtigung) aktiv.
• Öffnen Sie den Tab Connect.
• Verwenden Sie Setup Code oder den Modus Manual.
• Wenn Discovery blockiert ist, verwenden Sie im Bereich Advanced controls manuellen Host/Port. Für private LAN-Hosts funktioniert weiterhin ws://. Für Tailscale-/öffentliche Hosts aktivieren Sie TLS und verwenden Sie einen Endpunkt wss:// / Tailscale Serve.

• manueller Endpunkt (falls aktiviert), andernfalls
• das zuletzt entdeckte Gateway (best effort).

​

4) Pairing genehmigen (CLI)

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

​

5) Verifizieren, dass der Node verbunden ist

• Über den Node-Status:
  openclaw nodes status
  
• Über das Gateway:
  openclaw gateway call node.list --params "{}"
  

​

6) Chat + Verlauf

• Verlauf: chat.history (anzeigebereinigt normalisiert; Inline-Direktiven-Tags werden aus sichtbarem Text entfernt, Klartext-XML-Payloads für Tool-Aufrufe (einschließlich <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> und abgeschnittener Tool-Call-Blöcke) sowie geleakte ASCII-/vollbreite Modell-Control-Tokens werden entfernt, reine Assistant-Zeilen mit Silent-Token wie exakt NO_REPLY / no_reply werden ausgelassen, und übergroße Zeilen können durch Platzhalter ersetzt werden)
• Senden: chat.send
• Push-Updates (best effort): chat.subscribe → event:"chat"

​

7) Canvas + Kamera

​

Gateway Canvas Host (empfohlen für Web-Inhalte)

1. Erstellen Sie ~/.openclaw/workspace/canvas/index.html auf dem Gateway-Host.
2. Navigieren Sie den Node dorthin (LAN):

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

• canvas.eval, canvas.snapshot, canvas.navigate (verwenden Sie {"url":""} oder {"url":"/"}, um zum Standardgerüst zurückzukehren). canvas.snapshot gibt { format, base64 } zurück (standardmäßig format="jpeg").
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (Legacy-Alias canvas.a2ui.pushJSONL)

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

​

8) Sprache + erweiterte Android-Befehlsoberfläche

• Sprache: Android verwendet im Tab Voice einen einzigen Mikrofon-Ein/Aus-Ablauf mit Transkripterfassung und Wiedergabe über talk.speak. Lokales System-TTS wird nur verwendet, wenn talk.speak nicht verfügbar ist. Sprache wird beendet, wenn die App den Vordergrund verlässt.
• Umschalter für Voice Wake/Talk-Modus sind derzeit aus UX/Laufzeit von Android entfernt.
• Zusätzliche Android-Befehlsfamilien (Verfügbarkeit hängt von Gerät + Berechtigungen ab):
  • device.status, device.info, device.permissions, device.health
  • notifications.list, notifications.actions (siehe Benachrichtigungsweiterleitung unten)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

Einstiegspunkte für den Assistenten

​

Benachrichtigungsweiterleitung

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