OpenClaw Pairing Guide

Kennst du das? Du hast einen Dienst endlich zum Laufen gebracht, und plötzlich versuchen unbekannte Nutzer oder Geräte, sich zu verbinden. Man möchte die Kontrolle behalten, ohne jedes Mal komplexe Firewall-Regeln zu schreiben. Sicherheit sollte kein Hindernis sein, sondern ein klarer Prozess.

OpenClaw löst das mit “Pairing”. Das ist ein manueller Schritt, mit dem du als Besitzer Anfragen explizit bestätigst. Das betrifft sowohl Leute, die deinem Bot schreiben wollen, als auch neue Geräte, die deinem Netzwerk beitreten.

Voraussetzungen

Eine laufende OpenClaw-Instanz
Zugriff auf das CLI (openclaw Befehl)
Mindestens einen konfigurierten Channel (z. B. Telegram oder Signal)

Schnellstart

Hier ist der schnellste Weg, um den Zugriff zu verwalten.

1. DM Pairing (Nutzer-Zugriff)

Wenn ein Channel mit der DM-Policy pairing konfiguriert ist, werden Nachrichten von unbekannten Absendern erst verarbeitet, wenn du sie freigibst. Der Absender erhält einen 8-stelligen Code aus Großbuchstaben.

So listest und bestätigst du Anfragen:

# Alle Pairing-Anfragen für Telegram anzeigen
openclaw pairing list telegram

# Eine Anfrage mit dem Code bestätigen
openclaw pairing approve telegram <CODE>

Die Codes sind eine Stunde lang gültig. Pro Channel sind standardmäßig maximal 3 Anfragen gleichzeitig erlaubt. Weitere Anfragen werden ignoriert, bis eine bestehende Anfrage abläuft oder bestätigt wird.

2. Node Pairing (Geräte-Zugriff)

Nodes verbinden sich als Geräte mit der Rolle role: node. Jede Verbindung erfordert deine Zustimmung.

Empfohlener Weg über Telegram:

Schreibe deinem Bot in Telegram: /pair
Du erhältst eine Nachricht mit einer Anleitung und einen separaten Setup-Code.
Öffne die OpenClaw App auf deinem Smartphone -> Settings -> Gateway.
Füge den Setup-Code ein und verbinde dich.
Bestätige den Vorgang in Telegram mit: /pair approve

Alternativer Weg über das CLI:

# Offene Geräte-Anfragen anzeigen
openclaw devices list

# Gerät freigeben
openclaw devices approve <requestId>

# Gerät ablehnen
openclaw devices reject <requestId>

Fehlerbehebung

Hier sind Lösungen für Probleme, die laut Dokumentation auftreten können:

Anfragen werden ignoriert: Pro Channel sind nur 3 gleichzeitige DM-Pairing-Anfragen erlaubt. Warte, bis eine abläuft (nach 1 Stunde) oder lösche/bestätige eine vorhandene.
Code funktioniert nicht: Die Pairing-Codes verfallen nach 60 Minuten. Fordere nach Ablauf der Zeit einen neuen Code an.
Setup-Code Sicherheit: Behandle den base64-kodierten Setup-Code wie ein Passwort. Er enthält deine Gateway-URL und einen kurzlebigen Token.

Du findest die Status-Dateien für deine DMs unter ~/.openclaw/credentials/ und für deine Geräte unter ~/.openclaw/devices/. Gehe vorsichtig mit diesen Dateien um, da sie den Zugang zu deinem Assistenten steuern.

AI Setup Assistant

Nächste Schritte

OpenClaw Expert

Noch festgefahren?

Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.