Parowanie

“Parowanie” to krok jawnego zatwierdzenia przez wlasciciela w OpenClaw. Jest uzywany w dwoch miejscach:

  1. Parowanie DM (kto moze rozmawiac z botem)
  2. Parowanie wezlow (ktore urzadzenia/wezly moga dolaczyc do sieci gateway)

Kontekst bezpieczenstwa: Bezpieczenstwo

1) Parowanie DM (dostep do czatu przychodzacego)

Gdy kanal jest skonfigurowany z polityka DM pairing, nieznani nadawcy otrzymuja krotki kod, a ich wiadomosc nie jest przetwarzana do momentu zatwierdzenia.

Domyslne polityki DM sa udokumentowane w: Bezpieczenstwo

Kody parowania:

  • 8 znakow, wielkie litery, bez niejednoznacznych znakow (0O1I).
  • Wygasaja po 1 godzinie. Bot wysyla wiadomosc parowania tylko przy tworzeniu nowego zadania (mniej wiecej raz na godzine na nadawce).
  • Oczekujace zadania parowania DM sa ograniczone domyslnie do 3 na kanal; dodatkowe zadania sa ignorowane do momentu wygasniecia lub zatwierdzenia jednego z nich.

Zatwierdzanie nadawcy

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

Obslugiwane kanaly: telegram, whatsapp, signal, imessage, discord, slack, feishu.

Gdzie przechowywany jest stan

Przechowywany w ~/.openclaw/credentials/:

  • Oczekujace zadania: <channel>-pairing.json
  • Zatwierdzony magazyn listy dozwolonych:
    • Domyslne konto: <channel>-allowFrom.json
    • Konto inne niz domyslne: <channel>-<accountId>-allowFrom.json

Zachowanie zakresu konta:

  • Konta inne niz domyslne odczytuja/zapisuja tylko swoj zakresowy plik listy dozwolonych.
  • Domyslne konto uzywa pliku listy dozwolonych kanalu bez zakresu.

Traktuj te pliki jako wrazliwe (kontroluja dostep do twojego asystenta).

2) Parowanie wezlow urzadzen (iOS/Android/macOS/wezly bezgraficzne)

Wezly lacza sie z Gateway jako urzadzenia z role: node. Gateway tworzy zadanie parowania urzadzenia, ktore musi zostac zatwierdzone.

Parowanie przez Telegram (zalecane dla iOS)

Jesli uzywasz pluginu device-pair, mozesz wykonac pierwszorazowe parowanie urzadzenia calkowicie z Telegrama:

  1. W Telegramie wyslij wiadomosc do bota: /pair
  2. Bot odpowiada dwoma wiadomosciami: instrukcja i oddzielnym kodem konfiguracji (latwy do skopiowania/wklejenia w Telegramie).
  3. Na telefonie otworz aplikacje OpenClaw na iOS → Ustawienia → Gateway.
  4. Wklej kod konfiguracji i polacz sie.
  5. Wroc do Telegrama: /pair approve

Kod konfiguracji to zakodowany w base64 payload JSON zawierajacy:

  • url: adres URL WebSocket Gateway (ws://... lub wss://...)
  • bootstrapToken: krotkotrwaly token bootstrap dla pojedynczego urzadzenia uzywany do poczatkowego uzgadniania parowania

Traktuj kod konfiguracji jak haslo, dopoki jest wazny.

Zatwierdzanie wezla urzadzenia

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

Przechowywanie stanu parowania wezlow

Przechowywany w ~/.openclaw/devices/:

  • pending.json (krotkotrwaly; oczekujace zadania wygasaja)
  • paired.json (sparowane urzadzenia + tokeny)

Uwagi

  • Przestarzale API node.pair.* (CLI: openclaw nodes pending/approve) to oddzielny magazyn parowania nalezacy do gateway. Wezly WS nadal wymagaja parowania urzadzenia.

Powiazana dokumentacja

arrow_back
Poprzedni
Zalouser
Następny
Group Messages
arrow_forward