// dokumentacja openclaw

Parowanie w OpenClaw — zatwierdzanie dostępu DM i urządzeń

Wprowadzenie

Parowanie to mechanizm jawnego zatwierdzania przez właściciela, stosowany w dwóch kontekstach: parowanie DM (kontrola dostępu do czatu) i parowanie urządzenia (dostęp do sieci urządzeń). Ten rozdział wyjaśnia oba mechanizmy.

Parowanie DM — kontrola dostępu czatowego

Parowanie DM kontroluje, kto może wysyłać wiadomości do bota przez skonfigurowane kanały.

Charakterystyka kodów parowania

  • 8 wielkich liter bez niejednoznacznych symboli (0, O, 1, I są wykluczone)
  • Wygasają po 1 godzinie
  • Limit 3 oczekujących prośb na kanał (dodatkowe są ignorowane)
  • Wysyłane tylko przy nowych prośbach (mniej więcej raz na godzinę per nadawca)

Komendy zatwierdzania

openclaw pairing list telegram
openclaw pairing approve telegram KOD

To samo działa dla każdego obsługiwanego kanału — wystarczy podmienić nazwę.

Obsługiwane kanały

Parowanie DM obsługuje ponad 20 platform: BlueBubbles, Discord, Feishu, Google Chat, iMessage, IRC, LINE, Matrix, Mattermost, Microsoft Teams, Nextcloud Talk, Nostr, Signal, Slack, Synology Chat, Telegram, Twitch, WhatsApp, Zalo i inne.

Przechowywanie stanu

Pliki stanu w ~/.openclaw/credentials/:

  • Oczekujące: <channel>-pairing.json
  • Zatwierdzona lista (domyślne konto): <channel>-allowFrom.json
  • Zatwierdzona lista (niestandardowe konto): <channel>-<accountId>-allowFrom.json

Ważna uwaga

Zatwierdzenie parowania DM nie daje dostępu do komend grupowych. Grupy wymagają oddzielnej konfiguracji list dozwolonych (groupAllowFrom).

Parowanie urządzeń (Node Device Pairing)

Autoryzuje urządzenia (iOS, Android, macOS, headless) do połączenia w roli node.

Parowanie przez Telegram

  1. Wyślij do bota: /pair
  2. Otrzymaj instrukcję i kod konfiguracji zakodowany w base64
  3. W aplikacji iOS: Ustawienia → Gateway → wklej kod
  4. Wróć do Telegrama: /pair pending → zatwierdź

Zawartość kodu konfiguracji

  • URL WebSocket Gateway (ws:// lub wss://)
  • Jednorazowy token bootstrap do początkowego handshake

Zakresy tokenów

  • Tokeny node — puste zakresy []
  • Tokeny operatora — ograniczone do: operator.approvals, operator.read, operator.talk.secrets, operator.write
  • Walidacja zakresów jest prefiksowana rolą (nie ujednolicona pula)

Zarządzanie urządzeniami

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

Stan przechowywany w ~/.openclaw/devices/:

  • Oczekujące prośby: pending.json
  • Sparowane urządzenia: paired.json

Najlepsze praktyki

  • Regularnie przeglądaj listę sparowanych urządzeń i odwołuj nieużywane
  • Używaj trybu parowania jako domyślnej polityki DM — to najlepszy balans między wygodą a bezpieczeństwem
  • Pamiętaj o rozdzieleniu uprawnień DM i grupowych — parowanie DM nie otwiera dostępu do grup
  • Kody jednorazowe (bootstrap) tracą ważność po użyciu — nie mogą być ponownie wykorzystane
Wróc do dokumentacji