Aplikacja na Androida

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Migawka wsparcia

• Rola: aplikacja węzła towarzyszącego (Android nie hostuje Gateway).
• Wymagany Gateway: tak (uruchom go na macOS, Linux albo Windows przez WSL2).
• Instalacja: Pierwsze kroki + Parowanie.
• Gateway: Runbook + Konfiguracja.
  • Protokoły: Protokół Gateway (węzły + płaszczyzna sterowania).

​

Sterowanie systemowe

​

Runbook połączenia

• Preferowane: Tailscale Serve / Funnel z https://<magicdns> / wss://<magicdns>
• Obsługiwane także: dowolny inny URL Gateway wss:// z prawdziwym punktem końcowym TLS
• Nieszyfrowane ws:// pozostaje obsługiwane dla prywatnych adresów LAN / hostów .local, a także localhost, 127.0.0.1 oraz mostu emulatora Android (10.0.2.2)

​

Wymagania wstępne

• Możesz uruchomić Gateway na maszynie „głównej”.
• Urządzenie/emulator Android może dosięgnąć WebSocket gateway:
  • Ta sama sieć LAN z mDNS/NSD, albo
  • Ten sam tailnet Tailscale z użyciem Wide-Area Bonjour / unicast DNS-SD (zobacz niżej), albo
  • Ręczny host/port gateway (awaryjnie)
• Parowanie mobilne przez tailnet/publiczne nie używa surowych punktów końcowych IP tailnet ws://. Zamiast tego użyj Tailscale Serve albo innego URL wss://.
• Możesz uruchomić CLI (openclaw) na maszynie gateway (albo przez SSH).

​

1) Uruchom Gateway

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2) Zweryfikuj wykrywanie (opcjonalnie)

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

openclaw gateway discover --json

​

Wykrywanie tailnet (Wiedeń ⇄ Londyn) przez unicast DNS-SD

1. Skonfiguruj strefę DNS-SD (przykład openclaw.internal.) na hoście gateway i opublikuj rekordy _openclaw-gw._tcp.
2. Skonfiguruj Tailscale split DNS dla wybranej domeny, wskazując ten serwer DNS.

​

3) Połącz z Android

• Aplikacja utrzymuje połączenie z gateway przy życiu za pomocą usługi pierwszoplanowej (trwałe powiadomienie).
• Otwórz kartę Połącz.
• Użyj trybu Kod konfiguracji albo Ręczny.
• Jeśli wykrywanie jest zablokowane, użyj ręcznego hosta/portu w Zaawansowanych kontrolkach. Dla prywatnych hostów LAN ws:// nadal działa. Dla hostów Tailscale/publicznych włącz TLS i użyj punktu końcowego wss:// / Tailscale Serve.

• Ręczny punkt końcowy (jeśli włączony), w przeciwnym razie
• Ostatnio wykryty gateway (najlepszym staraniem).

​

Sygnały obecności alive

​

4) Zatwierdź parowanie (CLI)

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

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

​

5) Zweryfikuj, że węzeł jest połączony

• Przez status węzłów:
  openclaw nodes status
  
• Przez Gateway:
  openclaw gateway call node.list --params "{}"
  

​

6) Czat + historia

• Historia: chat.history (znormalizowana do wyświetlania; wbudowane tagi dyrektyw są usuwane z widocznego tekstu, tekstowe ładunki XML wywołań narzędzi (w tym <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> oraz obcięte bloki wywołań narzędzi) i ujawnione tokeny sterujące modelu ASCII/pełnej szerokości są usuwane, czyste wiersze asystenta z cichymi tokenami, takie jak dokładne NO_REPLY / no_reply, są pomijane, a nadmiernie duże wiersze mogą zostać zastąpione placeholderami)
• Wysyłanie: chat.send
• Aktualizacje push (najlepszym staraniem): chat.subscribe → event:"chat"

​

7) Canvas + kamera

​

Host Canvas Gateway (zalecany dla treści webowych)

1. Utwórz ~/.openclaw/workspace/canvas/index.html na hoście gateway.
2. Przejdź w węźle do niego (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 (użyj {"url":""} albo {"url":"/"}, aby wrócić do domyślnego szkieletu). canvas.snapshot zwraca { format, base64 } (domyślnie format="jpeg").
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL starszy alias)

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

​

8) Głos + rozszerzona powierzchnia poleceń Android

• Karta Głos: Android ma dwa jawne tryby przechwytywania. Mikrofon to ręczna sesja karty Głos, która wysyła każdą pauzę jako turę czatu i zatrzymuje się, gdy aplikacja opuszcza pierwszy plan albo użytkownik opuszcza kartę Głos. Rozmowa to ciągły tryb rozmowy, który słucha do czasu wyłączenia przełącznikiem albo rozłączenia węzła.
• Tryb rozmowy promuje istniejącą usługę pierwszoplanową z dataSync do dataSync|microphone przed rozpoczęciem przechwytywania, a potem degraduje ją po zatrzymaniu trybu rozmowy. Android 14+ wymaga deklaracji FOREGROUND_SERVICE_MICROPHONE, uprawnienia runtime RECORD_AUDIO oraz typu usługi mikrofonu w czasie działania.
• Wypowiadane odpowiedzi używają talk.speak przez skonfigurowanego dostawcę rozmowy gateway. Lokalny systemowy TTS jest używany tylko wtedy, gdy talk.speak jest niedostępne.
• Wybudzanie głosem pozostaje wyłączone w UX/runtime Android.
• Dodatkowe rodziny poleceń Android (dostępność zależy od urządzenia + uprawnień):
  • device.status, device.info, device.permissions, device.health
  • notifications.list, notifications.actions (zobacz Przekazywanie powiadomień niżej)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

Punkty wejścia asystenta

​

Przekazywanie powiadomień

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

​

Powiązane

• Aplikacja iOS
• Węzły
• Rozwiązywanie problemów z węzłem Android