Pairing

“Pairing” ist OpenClaws expliziter Freigabeschritt durch den Besitzer. Es wird an zwei Stellen verwendet:

  1. DM-Pairing (wer darf mit dem Bot sprechen)
  2. Node-Pairing (welche Geräte/Nodes dürfen dem Gateway-Netzwerk beitreten)

Sicherheitskontext: Security

1) DM-Pairing (eingehender Chat-Zugriff)

Wenn ein Channel mit der DM-Policy pairing konfiguriert ist, bekommen unbekannte Absender einen kurzen Code und ihre Nachricht wird nicht verarbeitet, bis du sie freigibst.

Standard-DM-Policies sind dokumentiert in: Security

Pairing-Codes:

  • 8 Zeichen, Großbuchstaben, keine mehrdeutigen Zeichen (0O1I).
  • Laufen nach 1 Stunde ab. Der Bot sendet die Pairing-Nachricht nur, wenn eine neue Anfrage erstellt wird (ungefähr einmal pro Stunde pro Absender).
  • Ausstehende DM-Pairing-Anfragen sind standardmäßig auf 3 pro Channel begrenzt; weitere Anfragen werden ignoriert, bis eine abläuft oder freigegeben wird.

Einen Absender freigeben

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

Unterstützte Channels: telegram, whatsapp, signal, imessage, discord, slack.

Wo die Daten gespeichert werden

Gespeichert unter ~/.openclaw/credentials/:

  • Ausstehende Anfragen: <channel>-pairing.json
  • Freigegebene Allowlist: <channel>-allowFrom.json

Diese Dateien sind sensibel — geh vorsichtig damit um (sie kontrollieren den Zugriff auf deinen Assistenten).

2) Node-Device-Pairing (iOS/Android/macOS/headless Nodes)

Nodes verbinden sich mit dem Gateway als Devices mit role: node. Das Gateway erstellt eine Device-Pairing-Anfrage, die freigegeben werden muss.

Ein Node-Device freigeben

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

Wo die Daten gespeichert werden

Gespeichert unter ~/.openclaw/devices/:

  • pending.json (kurzlebig; ausstehende Anfragen laufen ab)
  • paired.json (gepaarte Devices + Tokens)

Hinweise

  • Die Legacy-API node.pair.* (CLI: openclaw nodes pending/approve) ist ein separater Gateway-eigener Pairing-Store. WS-Nodes benötigen weiterhin Device-Pairing.

Verwandte Dokumentation