Czym jest węzeł mobilny
Węzeł mobilny (mobile node) to aplikacja OpenClaw na smartfon, która rozszerza możliwości agenta o dostęp do funkcji urządzenia mobilnego. Węzeł nie jest osobnym agentem — to rozszerzenie istniejącego agenta o dodatkowe narzędzia: kamerę, SMS, kontakty, kalendarz i inne zasoby telefonu.
Węzły mobilne są dostępne na dwie platformy:
- iOS — aplikacja na iPhone i iPad, dostępna w App Store
- Android — aplikacja na telefony i tablety z Androidem, dostępna w Google Play
Dzięki węzłom mobilnym Twój agent AI zyskuje „oczy" (kamera), „ręce" (wysyłanie SMS, tworzenie wydarzeń) i „pamięć kontekstową" (dostęp do kontaktów i kalendarza).
Parowanie węzła z Gateway
Węzeł mobilny musi być sparowany z Twoim Gateway OpenClaw, aby mógł się komunikować. Proces parowania:
- Wygeneruj kod parowania na serwerze:
Polecenie wyświetli 6-cyfrowy kod oraz kod QR.openclaw pair --type mobile - Otwórz aplikację mobilną i wybierz „Sparuj z Gateway"
- Zeskanuj kod QR lub wpisz 6-cyfrowy kod ręcznie
- Zaakceptuj uprawnienia — aplikacja poprosi o potwierdzenie, jakie funkcje urządzenia udostępniasz agentowi
- Gotowe — węzeł pojawi się w Control UI w sekcji „Urządzenia"
Parowanie jest jednorazowe. Węzeł pozostaje połączony z Gateway do momentu ręcznego odparowania.
Bezpieczeństwo parowania
- Kod parowania wygasa po 5 minutach
- Komunikacja między węzłem a Gateway jest szyfrowana (TLS)
- Możesz w każdej chwili odparować urządzenie w Control UI
- Każde urządzenie ma unikalny identyfikator — nie można sklonować parowania
Canvas — zrzuty ekranu
Funkcja Canvas pozwala agentowi na przechwytywanie i analizowanie zawartości ekranu telefonu.
- Agent może poprosić o zrzut ekranu: „Pokaż mi, co widzisz na ekranie"
- Zrzut jest przesyłany do Gateway i analizowany przez model vision
- Przydatne do debugowania aplikacji, pomocy technicznej zdalnej, odczytywania informacji z ekranu
Canvas wymaga jawnego zatwierdzenia przez użytkownika telefonu — pojawia się powiadomienie z pytaniem, czy chcesz udostępnić ekran.
Kamera
Węzeł mobilny daje agentowi dostęp do kamery urządzenia.
Zdjęcia
- Agent może poprosić o zdjęcie: „Zrób zdjęcie dokumentu na biurku"
- Użytkownik otrzymuje powiadomienie z podglądem kamery
- Po zatwierdzeniu zdjęcie jest przesyłane do agenta
- Agent analizuje obraz przez model vision (OCR, rozpoznawanie obiektów, opis sceny)
Wideo
- Agent może poprosić o krótki film (do 30 sekund)
- Wideo jest przetwarzane klatka po klatce
- Przydatne do analizy fizycznych procesów, inspekcji sprzętu, dokumentowania usterek
Tryb ciągły (live view)
W trybie live view kamera przesyła klatki w czasie rzeczywistym (1-5 fps). Agent widzi co się dzieje i może komentować na bieżąco. Przydatne np. do prowadzenia użytkownika przez procedurę naprawy.
Funkcje Android
Aplikacja na Androida oferuje dodatkowe możliwości, niedostępne na iOS ze względu na ograniczenia systemu Apple.
SMS
- Agent może wysyłać i odbierać SMS-y przez telefon użytkownika
- Przydatne do weryfikacji dwuskładnikowej, powiadomień, komunikacji z osobami bez komunikatorów
- Każdy SMS wymaga zatwierdzenia — agent nie może wysłać wiadomości bez Twojej zgody
Kontakty
- Agent może przeszukiwać książkę kontaktów: „Znajdź numer do Jana Kowalskiego"
- Może tworzyć nowe kontakty i aktualizować istniejące
- Dostęp do kontaktów jest opcjonalny — możesz go wyłączyć w ustawieniach uprawnień
Kalendarz
- Agent może odczytywać wydarzenia z kalendarza: „Co mam zaplanowane na jutro?"
- Może tworzyć nowe wydarzenia: „Dodaj spotkanie z Anną na piątek o 14:00"
- Obsługa wielu kalendarzy (osobisty, służbowy, udostępnione)
- Synchronizacja z Google Calendar i Samsung Calendar
Powiadomienia
- Agent może odczytywać powiadomienia z innych aplikacji (jeśli udzielisz uprawnienia Notification Listener)
- Przydatne do monitorowania: „Daj mi znać, gdy przyjdzie powiadomienie z aplikacji bankowej"
Uprawnienia
Węzeł mobilny stosuje granularne uprawnienia — Ty decydujesz, do czego agent ma dostęp:
- Kamera — osobne uprawnienie na zdjęcia i wideo
- Canvas (ekran) — osobne uprawnienie na zrzuty ekranu
- SMS — osobne uprawnienia na odczyt i wysyłanie
- Kontakty — osobne uprawnienia na odczyt i zapis
- Kalendarz — osobne uprawnienia na odczyt i zapis
- Lokalizacja — dostęp do GPS urządzenia
- Powiadomienia — dostęp do odczytu powiadomień innych aplikacji
Uprawnienia możesz zmienić w dowolnym momencie w ustawieniach aplikacji mobilnej lub w Control UI (sekcja Urządzenia > wybierz węzeł > Uprawnienia).
Lokalizacja
Gdy uprawnienie lokalizacji jest włączone, agent ma dostęp do bieżącej pozycji GPS urządzenia:
- Wyszukiwanie pobliskich miejsc: „Gdzie jest najbliższa apteka?"
- Nawigacja: „Jak dojechać do lotniska?"
- Geotagowanie zdjęć — agent wie, gdzie zdjęcie zostało zrobione
- Automatyzacja oparta na lokalizacji: „Gdy będę w biurze, przypomnij mi o spotkaniu"
Lokalizacja jest pobierana na żądanie (nie śledzona ciągle). Agent poprosi o pozycję tylko wtedy, gdy jest potrzebna do odpowiedzi.
Wskazówki praktyczne
- Bateria — węzeł mobilny jest zoptymalizowany pod kątem zużycia energii. W trybie oczekiwania pobiera minimalną ilość baterii. Więcej energii zużywa tryb live view kamery.
- Dane mobilne — przesyłanie zdjęć i wideo może zużywać dane mobilne. Ustaw limit w ustawieniach aplikacji.
- Wiele urządzeń — możesz sparować wiele węzłów mobilnych z jednym Gateway. Przydatne np. do dostępu do różnych kamer.
- Stabilność połączenia — węzeł automatycznie ponawia próby połączenia po utracie sieci. Wiadomości są buforowane i wysyłane po przywróceniu łączności.