Dotyczy OpenClaw v2026.2 | Ten artykuł zakłada, że Gateway jest już wdrożony i chcesz korzystać z niego na urządzeniu mobilnym.

TL;DR: Aplikacja iOS/Android łączy się jako „węzeł" z Gateway, udostępniając możliwości aparatu, nagrywania ekranu, lokalizacji i powiadomień. Proces parowania: otwórz aplikację → odkryj Gateway → wprowadź kod parowania. Komendy: camera.snap (zdjęcie), screen.record (nagrywanie ekranu), location.get (lokalizacja), notification.send (powiadomienie). Budzenie głosowe obsługiwane tylko na iOS — powiedz “Hey Claw”.

Przegląd funkcji mobilnych

Porównanie funkcji

Schemat architektury

[Aplikacja iOS/Android] <--WiFi/Sieć komórkowa--> [Gateway] <---> [Agent]
        |                                    |
    [Node API]                        [Narzędzia/Umiejętności]
        |                                    |
   [Możliwości urządzenia]            [Usługi zewnętrzne]
    - Aparat
    - Ekran
    - Lokalizacja
    - Powiadomienia

Instalacja na iOS

Wymagania systemowe

Metody instalacji

Metoda 1: TestFlight (zalecana)

1. Dołącz do testów TestFlight
2. Zainstaluj aplikację OpenClaw iOS
3. Otwórz aplikację i przeprowadź parowanie

Metoda 2: Kompilacja ze źródeł

# Klonowanie repozytorium
git clone https://github.com/openclaw/openclaw.git
cd openclaw/apps/ios

# Instalacja zależności
pod install

# Otwarcie Xcode
open OpenClaw.xcworkspace

# Kompilacja i instalacja na urządzeniu

Konfiguracja uprawnień iOS

Instalacja na Androidzie

Wymagania systemowe

Metody instalacji

Metoda 1: Instalacja APK

1. Pobierz najnowszy plik APK
2. Zezwól na instalację z nieznanych źródeł
3. Zainstaluj i otwórz aplikację

Metoda 2: Kompilacja ze źródeł

# Klonowanie repozytorium
git clone https://github.com/openclaw/openclaw.git
cd openclaw/apps/android

# Kompilacja
./gradlew assembleDebug

# Instalacja na urządzeniu
adb install app/build/outputs/apk/debug/app-debug.apk

Konfiguracja uprawnień Android

Parowanie węzłów

Proces parowania

sequenceDiagram
    participant A as Aplikacja mobilna
    participant G as Gateway
    participant D as Usługa odkrywania
    
    A->>D: Rozgłaszanie żądania odkrywania
    D-->>A: Odkryto Gateway
    A->>G: Żądanie parowania
    G-->>A: Zwrócenie kodu parowania
    A->>A: Wyświetlenie kodu parowania
    Note over A,G: Użytkownik wprowadza kod parowania w aplikacji
    A->>G: Przesłanie kodu parowania
    G->>G: Weryfikacja kodu parowania
    G-->>A: Parowanie zakończone sukcesem
    A->>G: Rejestracja możliwości węzła
    G-->>A: Potwierdzenie rejestracji

Kroki parowania

1. Upewnij się, że Gateway działa

# Uruchomienie Gateway
openclaw gateway --port 18789

# Sprawdzenie statusu
openclaw health

2. Otwórz aplikację mobilną

Otwórz aplikację OpenClaw na iOS/Androidzie.

3. Odkryj Gateway

Aplikacja automatycznie skanuje sieć lokalną w poszukiwaniu Gateway lub ręcznie wprowadź adres Gateway:

http://192.168.1.100:18789

4. Pobierz kod parowania

Sprawdź kod parowania w terminalu Gateway:

openclaw pairing list

# Przykładowe wyjście:
# Node     Code     Platform
# ios-1    ABC123   iOS
# android-1 XYZ789  Android

5. Wprowadź kod parowania

Wprowadź kod parowania w aplikacji, aby zakończyć proces parowania.

Konfiguracja węzła

{
  "nodes": {
    "ios-1": {
      "platform": "ios",
      "capabilities": ["camera", "screen_record", "location", "notification"],
      "autoConnect": true
    },
    "android-1": {
      "platform": "android",
      "capabilities": ["camera", "screen_record", "location", "notification", "sms"],
      "autoConnect": true
    }
  }
}

Funkcja aparatu

Zdjęcie do analizy AI

Użytkownik: Sprawdź, co mam w lodówce

Agent: Dobrze, spójrzmy przez aparat Twojego telefonu...
[Wywołanie camera.snap]
[Analiza obrazu]
W Twojej lodówce jest:
- Mleko (pół butelki)
- Jajka (6 sztuk)
- Ogórki (2 sztuki)
- Pomidory (kilka)
Proponuję zrobić jajecznicę z pomidorami~

Komendy aparatu

Konfiguracja aparatu

{
  "nodes": {
    "ios-1": {
      "camera": {
        "defaultCamera": "back",
        "quality": "high",
        "saveToGallery": false
      }
    }
  }
}

Nagrywanie ekranu

Nagrywanie i udostępnianie

Użytkownik: Pokaż mi, jak używać tej aplikacji

Agent: Dobrze, proszę rozpocznij nagrywanie ekranu...

[Użytkownik obsługuje aplikację]

Agent: Widzę, to jest aplikacja do zarządzania zadaniami.
Możesz:
1. Kliknąć + w prawym dolnym rogu, aby dodać zadanie
2. Przesunąć w lewo, aby usunąć zadanie
3. Kliknąć zadanie, aby edytować szczegóły

Konfiguracja nagrywania ekranu

{
  "nodes": {
    "ios-1": {
      "screenRecord": {
        "maxDuration": 300,
        "quality": "medium",
        "withAudio": true
      }
    }
  }
}

Usługa lokalizacji

Pobieranie bieżącej lokalizacji

Użytkownik: Co dobrego jest w pobliżu do jedzenia?

Agent: Sprawdzam Twoją lokalizację...
[Wywołanie location.get]
Jesteś obecnie w okolicy Rynku Głównego w Krakowie.
Polecam kilka restauracji z wysokimi ocenami:
1. Pod Aniołami - 4.8, kuchnia polska
2. Kogel Mogel - 4.7, kuchnia europejska
3. ...

Komendy lokalizacji

Konfiguracja lokalizacji

{
  "nodes": {
    "ios-1": {
      "location": {
        "accuracy": "high",
        "distanceFilter": 100
      }
    }
  }
}

Funkcja powiadomień

Wysyłanie powiadomień

Agent: Zadanie zostało wykonane, wysyłam powiadomienie na Twój telefon.

[Wywołanie notification.send]

Telefon otrzymuje powiadomienie:
Tytuł: Zadanie wykonane
Treść: Kod został wdrożony na środowisko produkcyjne

Konfiguracja powiadomień

{
  "nodes": {
    "ios-1": {
      "notification": {
        "enabled": true,
        "sound": true,
        "badge": true
      }
    }
  }
}

Budzenie głosowe (iOS)

Konfiguracja budzenia głosowego

{
  "nodes": {
    "ios-1": {
      "voiceWake": {
        "enabled": true,
        "keyword": "hey claw",
        "sensitivity": "medium"
      }
    }
  }
}

Korzystanie z budzenia głosowego

1. Powiedz “Hey Claw”
2. Aplikacja automatycznie rozpoczyna nasłuchiwanie
3. Wypowiedz swoje pytanie
4. Agent odpowiada

Canvas na urządzeniach mobilnych

Canvas na urządzeniu mobilnym

Mobilny Canvas zapewnia to samo doświadczenie wizualne co wersja desktopowa:

• Interaktywne panele kontrolne
• Wyświetlanie danych w czasie rzeczywistym
• Formularze wprowadzania danych
• Wykresy i tabele

Optymalizacja Canvas na urządzeniach mobilnych

{
  "canvas": {
    "mobile": {
      "adaptiveLayout": true,
      "touchGestures": true,
      "performanceMode": "balanced"
    }
  }
}

Zarządzanie węzłami

Przeglądanie węzłów

# Lista wszystkich węzłów
openclaw nodes list

# Przykładowe wyjście:
# Node        Platform  Status   Capabilities
# ios-1       iOS       online   camera,location,notification
# android-1   Android   offline  camera,location,sms

# Szczegóły węzła
openclaw nodes show ios-1

Operacje na węzłach

# Włączenie węzła
openclaw nodes enable ios-1

# Wyłączenie węzła
openclaw nodes disable ios-1

# Odłączenie węzła
openclaw nodes disconnect ios-1

# Zmiana nazwy węzła
openclaw nodes rename ios-1 --name "Mój iPhone"

Rozwiązywanie problemów

Węzeł nie może się połączyć

# Sprawdzenie statusu Gateway
openclaw health

# Sprawdzenie sieci
ping 192.168.1.100

# Wyświetlenie logów węzła
openclaw logs --node ios-1

Problemy z uprawnieniami

# Sprawdzenie uprawnień węzła
openclaw nodes permissions ios-1

# Przykładowe wyjście:
# Permission      Status
# Camera          Granted
# Location        Granted
# Notification    Granted
# Microphone      Denied

Nieudane parowanie

1. Upewnij się, że Gateway działa
2. Sprawdź połączenie sieciowe (ta sama sieć lokalna)
3. Sprawdź ustawienia firewalla
4. Spróbuj ponownie sparować

Podsumowanie

Węzły mobilne rozszerzają możliwości OpenClaw:

• Aparat: analiza zdjęć, nagrywanie wideo
• Lokalizacja: pobieranie bieżącej pozycji
• Powiadomienia: push wiadomości na telefon
• Canvas: mobilny interfejs wizualny
• Budzenie głosowe: obsługa hands-free

Historia zmian:

• 2026-02-26: Pierwsza publikacja

Nawigacja po serii:

• ← Poprzedni: Zdalne wdrażanie
• → Następny: Automatyzacja i zadania cykliczne