Parowanie

1. Parowanie wiadomości prywatnych (kto może komunikować się z botem)
2. Parowanie Node (które urządzenia/węzły mogą dołączać do sieci Gateway)

​

1) Parowanie wiadomości prywatnych (dostęp do czatu przychodzącego)

• 8 znaków, wielkie litery, bez niejednoznacznych znaków (0O1I).
• Wygasają po 1 godzinie. Bot wysyła wiadomość dotyczącą parowania tylko po utworzeniu nowego żądania (w przybliżeniu raz na godzinę dla każdego nadawcy).
• Liczba oczekujących żądań parowania wiadomości prywatnych jest ograniczona do 3 na konto kanału; dodatkowe żądania są ignorowane do czasu wygaśnięcia lub zatwierdzenia jednego z nich.

​

Zatwierdzanie nadawcy

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

​

Grupy nadawców wielokrotnego użytku

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
        whatsapp: ["+15551234567"],
      },
    },
  },
  channels: {
    telegram: { dmPolicy: "allowlist", allowFrom: ["accessGroup:operators"] },
    whatsapp: { groupPolicy: "allowlist", groupAllowFrom: ["accessGroup:operators"] },
  },
}

​

Lokalizacja stanu

• oczekujące żądania w channel_pairing_requests
• zatwierdzeni nadawcy w channel_pairing_allow_entries

• każde żądanie i każdy zatwierdzony nadawca są identyfikowani według kanału i konta
• środowisko uruchomieniowe odczytuje tylko kanoniczne wiersze SQLite; nie scala starszych plików

​

2) Parowanie urządzeń Node (węzły iOS/Android/macOS/bez interfejsu)

​

Parowanie z poziomu Control UI (zalecane)

1. Otwórz Control UI i przejdź do Settings → Devices.
2. Na stronie Devices kliknij Pair mobile device.
3. Pozostaw wybraną opcję Full access (recommended) lub wybierz Limited access, aby pominąć administracyjne elementy sterujące Gateway.
4. Kliknij Create setup code.
5. Na telefonie otwórz aplikację OpenClaw → Settings → Gateway.
6. Zeskanuj kod QR lub wklej kod konfiguracji, a następnie nawiąż połączenie.

​

Parowanie przez Telegram

1. W Telegram wyślij do bota wiadomość: /pair
2. Bot odpowie dwiema wiadomościami: wiadomością z instrukcjami i oddzielną wiadomością zawierającą kod konfiguracji (łatwy do skopiowania i wklejenia w Telegram).
3. Na telefonie otwórz aplikację OpenClaw na iOS → Settings → Gateway.
4. Zeskanuj kod QR (/pair qr) lub wklej kod konfiguracji i nawiąż połączenie.
5. Oficjalna aplikacja mobilna połączy się automatycznie. Jeśli /pair pending wyświetli żądanie, przed jego zatwierdzeniem należy sprawdzić rolę i zakresy.

• url: adres URL WebSocket Gateway (ws://... lub wss://...)
• urls: jeśli są dostępne, uporządkowane trasy LAN/Tailnet, które aplikacja mobilna może wypróbować
• bootstrapToken: jednorazowy token inicjujący pierwszą procedurę uzgadniania parowania; Gateway unieważnia go po 10 minutach

• bezpieczna konfiguracja wss:// (lub sprzężenie zwrotne tego samego hosta) domyślnie zapewnia node oraz pełny natywny mobilny dostęp operator
• przekazany token node pozostaje scopes: []
• domyślny przekazany token operator obejmuje operator.admin, operator.approvals, operator.read, operator.talk.secrets oraz operator.write
• Opcja Control UI Limited access oraz openclaw qr --limited pomijają operator.admin, zachowując pozostałe zakresy operatora
• konfiguracja zwykłego tekstu ws:// w sieci LAN automatycznie używa tego samego ograniczonego profilu; skonfiguruj wss:// lub Tailscale Serve i wygeneruj nowy kod, aby uzyskać pełny dostęp
• późniejsze obracanie lub unieważnianie tokenów pozostaje ograniczone zarówno przez zatwierdzoną umowę roli urządzenia, jak i zakresy operatora sesji wywołującej

​

Zatwierdzanie urządzenia Node

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

​

Opcjonalne automatyczne zatwierdzanie Node z zaufanych zakresów CIDR

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

​

Przechowywanie stanu parowania Node

• oczekujące żądania parowania urządzeń (krótkotrwałe; wygasają po 5 minutach)
• sparowane urządzenia i tokeny

​

Uwagi

• Interfejs API node.pair.* (CLI: openclaw nodes pending|approve|reject|remove|rename) zarządza zatwierdzeniami możliwości Node przechowywanymi w tych samych rekordach sparowanych urządzeń. Węzły WS nadal wymagają parowania urządzenia; zobacz Parowanie Node.
• Rekord parowania jest trwałym źródłem prawdy o zatwierdzonych rolach. Aktywne tokeny urządzeń pozostają ograniczone do tego zatwierdzonego zestawu ról; przypadkowy wpis tokenu spoza zatwierdzonych ról nie tworzy nowego dostępu.

​

Powiązana dokumentacja

• Model bezpieczeństwa i wstrzykiwanie promptów: Bezpieczeństwo
• Bezpieczne aktualizowanie (uruchom doctor): Aktualizowanie
• Konfiguracje kanałów:
  • Telegram: Telegram
  • WhatsApp: WhatsApp
  • Signal: Signal
  • iMessage: iMessage
  • Discord: Discord
  • Slack: Slack