CLI commands
Kopplung
openclaw pairing
Genehmigen oder prüfen Sie DM-Kopplungsanfragen für Kanäle, die Kopplung unterstützen (nur Chat-DMs – für die Kopplung von Nodes/Geräten wird openclaw devices verwendet).
Verwandt: Kopplungsablauf
Dieselben ausstehenden Anfragen können in der Control UI unter Settings → Channels → DM access requests geprüft werden. Die Control UI unterstützt das Genehmigen, die optionale Benachrichtigung der anfragenden Person und das Verwerfen. Beim Verwerfen wird die aktuelle Anfrage entfernt, der Absender jedoch nicht dauerhaft blockiert.
Befehle
openclaw pairing list telegramopenclaw pairing list --channel telegram --account workopenclaw pairing list telegram --json openclaw pairing approve <code>openclaw pairing approve telegram <code>openclaw pairing approve --channel telegram --account work <code> --notifypairing list
Ausstehende Kopplungsanfragen für einen Kanal auflisten.
| Option | Beschreibung |
|---|---|
[channel] |
positionale Kanal-ID |
--channel <channel> |
explizite Kanal-ID |
--account <accountId> |
Konto-ID für Kanäle mit mehreren Konten |
--json |
maschinenlesbare Ausgabe |
Wenn mehrere kopplungsfähige Kanäle konfiguriert sind, geben Sie einen Kanal positional oder mit --channel an. Erweiterungskanäle funktionieren, sofern die Kanal-ID gültig ist.
pairing approve
Einen ausstehenden Kopplungscode genehmigen und diesen Absender zulassen.
Verwendung:
openclaw pairing approve <channel> <code>openclaw pairing approve --channel <channel> <code>openclaw pairing approve <code>, wenn genau ein kopplungsfähiger Kanal konfiguriert ist
Optionen: --channel <channel>, --account <accountId>, --notify (eine Bestätigung über denselben Kanal an die anfragende Person senden).
Ersteinrichtung des Eigentümers
Wenn commands.ownerAllowFrom beim Genehmigen eines Kopplungscodes leer ist, trägt die CLI den genehmigten Absender außerdem als Befehlseigentümer ein und verwendet dafür einen kanalspezifischen Eintrag wie telegram:123456789. Dadurch wird nur der erste Eigentümer eingerichtet – spätere Kopplungsgenehmigungen ersetzen oder erweitern commands.ownerAllowFrom niemals. Die Control UI zeigt diese Rechteerweiterung als separates, durch operator.admin geschütztes Kontrollkästchen an, statt sie automatisch anzuwenden.
Der Befehlseigentümer ist das Konto der menschlichen Bedienperson, das ausschließlich Eigentümern vorbehaltene Befehle ausführen und gefährliche Aktionen wie /diagnostics, /export-session, /export-trajectory, /config sowie Ausführungsgenehmigungen autorisieren darf. Durch die Kopplung kann ein Absender lediglich mit dem Agenten kommunizieren; abgesehen von dieser einmaligen Ersteinrichtung gewährt sie für sich genommen keine Eigentümerrechte.
Wenn Sie einen Absender genehmigt haben, bevor diese Ersteinrichtung eingeführt wurde, führen Sie openclaw doctor aus. Der Befehl warnt, wenn kein Befehlseigentümer konfiguriert ist, und zeigt den genauen openclaw config set commands.ownerAllowFrom ...-Befehl zur Behebung an.
