Aplikacja na Androida

​

Przegląd obsługi

• Rola: aplikacja Node towarzyszącego (Android nie hostuje Gateway).
• Wymagany Gateway: tak (należy go uruchomić w systemie macOS, Linux lub Windows za pośrednictwem WSL2).
• Instalacja: Google Play lub OpenClaw-Android.apk z obsługiwanego wydania GitHub, Pierwsze kroki dla Gateway, a następnie Parowanie.
• Gateway: Podręcznik operacyjny + Konfiguracja.
  • Protokoły: protokół Gateway (węzły + płaszczyzna sterowania).

​

Instalacja spoza Google Play

release_tag=vYYYY.M.PATCH
gh release download "$release_tag" \
  --repo openclaw/openclaw \
  --pattern OpenClaw-Android.apk \
  --pattern OpenClaw-Android-SHA256SUMS.txt
sha256sum --check OpenClaw-Android-SHA256SUMS.txt
gh attestation verify OpenClaw-Android.apk \
  --repo openclaw/openclaw \
  --signer-workflow openclaw/openclaw/.github/workflows/android-release.yml \
  --source-ref "refs/tags/${release_tag}" \
  --deny-self-hosted-runners

​

Klonowanie ekranu i sterowanie Androidem ze zdalnego komputera Mac

​

Przed rozpoczęciem

• Zainstaluj Tailscale na urządzeniu z Androidem i komputerze Mac, a następnie połącz oba urządzenia z tym samym tailnetem.
• W systemie Android włącz Developer options i USB debugging. W systemie Android 16 opcja Wireless debugging znajduje się w Settings > System > Developer options. Zobacz opcje programistyczne Androida.
• Zainstaluj scrcpy i ADB na komputerze Mac:
  brew install scrcpy
  brew install --cask android-platform-tools
  
• Urządzenie z Androidem musi być dostępne podczas pierwszego połączenia. Android musi zatwierdzić klucz ADB każdego komputera Mac, zanim będzie on mógł sterować urządzeniem.

​

Włączanie ADB przez TCP

adb devices
adb tcpip 5555

​

Zezwalanie tylko komputerowi Mac pełniącemu rolę kontrolera

{
  grants: [
    {
      src: ["<remote-mac-tailnet-ip>"],
      dst: ["<android-tailnet-ip>"],
      ip: ["tcp:5555"],
    },
  ],
}

​

Nawiązywanie połączenia i rozpoczynanie klonowania ekranu

adb connect <android-tailnet-ip>:5555
adb devices
scrcpy --serial <android-tailnet-ip>:5555

​

Rozwiązywanie problemów

• Connection timed out: sprawdź uprawnienie tailnetu dla portu TCP 5555. Pomyślne tailscale ping potwierdza osiągalność urządzenia równorzędnego, a nie to, że zasady zezwalają na dostęp do tego portu TCP. Przetestuj za pomocą nc -vz <android-tailnet-ip> 5555 na komputerze Mac.
• unauthorized: odblokuj Androida i zatwierdź klucz ADB zdalnego komputera Mac albo usuń nieaktualną stację roboczą w Wireless debugging > Paired devices i sparuj ją ponownie.
• Connection refused: ponownie nawiąż połączenie lokalne i jeszcze raz uruchom adb tcpip 5555.
• Na liście znajduje się więcej niż jedno urządzenie: zachowaj jawny argument --serial <android-tailnet-ip>:5555.

adb disconnect <android-tailnet-ip>:5555

​

Procedura nawiązywania połączenia

• Preferowane: Tailscale Serve / Funnel z https://<magicdns> / wss://<magicdns>
• Obsługiwane również: dowolny inny adres URL Gateway wss:// z rzeczywistym punktem końcowym TLS
• Nieszyfrowane ws:// pozostaje obsługiwane dla adresów w prywatnej sieci LAN / hostów .local, a także localhost, 127.0.0.1 i mostka emulatora Androida (10.0.2.2); konfiguracja poza interfejsem pętli zwrotnej automatycznie korzysta z ograniczonego dostępu operatora

​

Wymagania wstępne

• Gateway działa na innym komputerze (lub jest osiągalny przez SSH).
• Urządzenie lub emulator z Androidem może połączyć się z WebSocket Gateway:
  • Ta sama sieć LAN z mDNS/NSD, lub
  • Ten sam tailnet Tailscale korzystający z Wide-Area Bonjour / DNS-SD w trybie unicast (zobacz poniżej), lub
  • Ręcznie określony host/port Gateway (rozwiązanie awaryjne)
• Parowanie mobilne przez tailnet lub host publiczny nie korzysta z nieprzetworzonych punktów końcowych IP tailnetu ws://. Zamiast tego użyj Tailscale Serve lub innego adresu URL wss://.
• CLI openclaw jest dostępne na komputerze Gateway (lub przez SSH), aby zatwierdzać żądania parowania.

​

1. Uruchamianie Gateway

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2. Weryfikowanie wykrywania (opcjonalnie)

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

openclaw gateway discover --json

​

Wykrywanie między sieciami za pomocą DNS-SD w trybie unicast

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

​

3. Nawiązywanie połączenia z Androida

• Aplikacja utrzymuje aktywne połączenie z Gateway za pomocą usługi pierwszoplanowej (trwałego powiadomienia).
• Otwórz kartę Connect.
• Użyj trybu Setup Code lub Manual.
• Jeśli wykrywanie jest blokowane, użyj ręcznie określonego hosta/portu w sekcji Advanced controls. W przypadku hostów w prywatnej sieci LAN ws:// nadal działa. W przypadku hostów Tailscale lub publicznych włącz TLS i użyj punktu końcowego wss:// / Tailscale Serve.

​

Wiele Gateway

• Settings -> Gateways wyświetla sparowane Gateway i oznacza aktywny. Dotknij wpisu, aby się przełączyć; aplikacja kończy bieżące sesje i ponownie łączy się z wybranym Gateway.
• Karta Connect wyświetla szybki przełącznik, gdy sparowano więcej niż jeden Gateway.
• Poświadczenia, tokeny urządzeń, zaufanie TLS, historia czatu i wiadomości oczekujące w trybie offline są przechowywane osobno dla każdego Gateway. Przełączanie nigdy nie miesza stanu między Gateway, a wiadomości umieszczone w kolejce podczas pracy offline są dostarczane wyłącznie do Gateway, dla którego zostały utworzone.
• Forget usuwa wpis Gateway z rejestru wraz z jego poświadczeniami, tokenami urządzeń, przypięciem TLS i czatami w pamięci podręcznej.

​

Sygnały aktywnej obecności

​

4. Zatwierdzanie parowania (CLI)

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

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

​

5. Sprawdzenie połączenia węzła

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

​

6. Czat i historia

• Historia: chat.history (znormalizowana na potrzeby wyświetlania — usuwane są wbudowane znaczniki dyrektyw, tekstowe ładunki XML wywołań narzędzi (<tool_call>, <function_call>, <tool_calls>, <function_calls> oraz ich skrócone warianty), a także ujawnione tokeny sterujące modelu w formacie ASCII lub pełnej szerokości; wiersze asystenta zawierające wyłącznie tokeny ciszy, takie jak dokładne NO_REPLY / no_reply, są pomijane; zbyt duże wiersze mogą zostać zastąpione symbolami zastępczymi)
• Wysyłanie: chat.send
• Trwałe wysyłanie: każda wysyłka (tekst, wybrane obrazy i notatki głosowe) jest zapisywana w dzienniku lokalnej skrzynki nadawczej przypisanej do danego Gateway przed podjęciem jakiejkolwiek próby sieciowej, dzięki czemu zamknięcie aplikacji nie powoduje utraty przesłanych danych. Wysyłki umieszczone w kolejce w trybie offline są dostarczane po ponownym połączeniu w kolejności, ze stabilnymi kluczami idempotencji, a wysyłka zostaje usunięta z kolejki dopiero wtedy, gdy tura jest widoczna w kanonicznym chat.history — samo potwierdzenie nie jest uznawane za dowód dostarczenia. Niejednoznaczne wyniki (utrata potwierdzenia, zamknięcie aplikacji w trakcie wysyłania, ponowne uruchomienie Gateway przed zapisem transkrypcji) są wyświetlane jako widoczne wiersze z jawnymi opcjami Ponów/Usuń, zamiast automatycznego ponawiania wysyłki. Polecenia ukośnikowe nigdy nie są automatycznie odtwarzane po ponownym połączeniu; oczekują na jawne ponowienie. Kolejka jest ograniczona (50 wiadomości i 48 MB danych załączników na Gateway), a niewysłane wiersze wygasają po 48 godzinach. Wersje robocze w edytorze, które nigdy nie zostały przesłane, nie są trwale zachowywane między procesami.
• Aktualizacje push (w miarę możliwości): chat.subscribe -> event:"chat"
• Odsłuchiwanie: należy przytrzymać wiadomość asystenta i wybrać Odsłuchaj, aby ją usłyszeć; dźwięk jest generowany przez gateway tts.speak przy użyciu skonfigurowanego łańcucha dostawców TTS, a systemowy TTS urządzenia jest używany, gdy gateway nie może wygenerować dźwięku. Odtwarzanie zatrzymuje się po zmianie sesji, rozpoczęciu nowego czatu, przejściu aplikacji do tła lub zamknięciu czatu.

​

7. Canvas i kamera

​

Host Canvas w Gateway (zalecany dla treści internetowych)

1. Utwórz ~/.openclaw/workspace/canvas/index.html na hoście Gateway.
2. Przejdź do niego w węźle (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 (aby powrócić do domyślnego szkieletu, należy użyć {"url":""} lub {"url":"/"}). canvas.snapshot zwraca { format, base64 } (domyślnie format="jpeg").
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (starszy alias canvas.a2ui.pushJSONL). Korzystają one z dołączonej strony A2UI należącej do aplikacji, umożliwiającej renderowanie z obsługą działań.

​

8. Głos i rozszerzony zestaw poleceń systemu Android

• Karta głosu: Android ma dwa jawne tryby przechwytywania. Mikrofon to ręczna sesja na karcie głosu, która wysyła każdą pauzę jako turę czatu i kończy się, gdy aplikacja opuszcza pierwszy plan lub użytkownik opuszcza kartę głosu. Rozmowa to ciągły tryb rozmowy, który nasłuchuje do momentu wyłączenia lub rozłączenia węzła.
• Tryb rozmowy podnosi rangę istniejącej usługi pierwszoplanowej z connectedDevice do connectedDevice|microphone przed rozpoczęciem przechwytywania, a następnie obniża ją po zatrzymaniu trybu rozmowy. Usługa węzła deklaruje FOREGROUND_SERVICE_CONNECTED_DEVICE z CHANGE_NETWORK_STATE; Android 14+ wymaga także deklaracji FOREGROUND_SERVICE_MICROPHONE, przyznania uprawnienia RECORD_AUDIO w czasie działania oraz typu usługi mikrofonu w czasie działania.
• Domyślnie funkcja rozmowy w systemie Android korzysta z natywnego rozpoznawania mowy, czatu Gateway oraz talk.speak za pośrednictwem skonfigurowanego dostawcy rozmowy Gateway. Lokalny systemowy TTS jest używany tylko wtedy, gdy talk.speak jest niedostępne.
• Funkcja rozmowy w systemie Android używa przekaźnika Gateway działającego w czasie rzeczywistym tylko wtedy, gdy talk.realtime.mode ma wartość realtime, a talk.realtime.transport ma wartość gateway-relay.
• Android nie ogłasza możliwości voiceWake. Do wprowadzania głosowego należy używać funkcji Mikrofon lub Rozmowa.
• Dodatkowe rodziny poleceń systemu Android (dostępność zależy od urządzenia, uprawnień i ustawień użytkownika):
  • device.status, device.info, device.permissions, device.health
  • device.apps tylko wtedy, gdy włączono Settings > Phone Capabilities > Installed Apps; domyślnie wyświetla aplikacje widoczne w programie uruchamiającym (aby uzyskać pełną listę, należy przekazać includeNonLaunchable).
  • notifications.list, notifications.actions (zobacz Przekazywanie powiadomień poniżej)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

9. Pliki obszaru roboczego (tylko do odczytu)

​

Przeglądanie zatwierdzeń poleceń

​

Punkty wejścia asystenta

​

Przekazywanie powiadomień

​

Powiązane

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