`openclaw devices`

Verwalte Ger\u00e4te-Pairing-Anfragen und ger\u00e4tebezogene Tokens.

Befehle

`openclaw devices list`

Ausstehende Pairing-Anfragen und gekoppelte Ger\u00e4te auflisten.

openclaw devices list
openclaw devices list --json

`openclaw devices remove <deviceId>`

Einen gekoppelten Ger\u00e4teeintrag entfernen.

openclaw devices remove <deviceId>
openclaw devices remove <deviceId> --json

`openclaw devices clear --yes [--pending]`

Gekoppelte Ger\u00e4te in Masse l\u00f6schen.

openclaw devices clear --yes
openclaw devices clear --yes --pending
openclaw devices clear --yes --pending --json

`openclaw devices approve [requestId] [--latest]`

Eine ausstehende Ger\u00e4te-Pairing-Anfrage genehmigen. Wenn requestId weggelassen wird, genehmigt OpenClaw automatisch die neueste ausstehende Anfrage.

openclaw devices approve
openclaw devices approve <requestId>
openclaw devices approve --latest

`openclaw devices reject <requestId>`

Eine ausstehende Ger\u00e4te-Pairing-Anfrage ablehnen.

openclaw devices reject <requestId>

`openclaw devices rotate --device <id> --role <role> [--scope <scope...>]`

Ein Ger\u00e4te-Token f\u00fcr eine bestimmte Rolle rotieren (optional mit Scope-Aktualisierung).

openclaw devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write

`openclaw devices revoke --device <id> --role <role>`

Ein Ger\u00e4te-Token f\u00fcr eine bestimmte Rolle widerrufen.

openclaw devices revoke --device <deviceId> --role node

H\u00e4ufige Optionen

--url <url>: Gateway-WebSocket-URL (Standard ist gateway.remote.url, falls konfiguriert).
--token <token>: Gateway-Token (falls erforderlich).
--password <password>: Gateway-Passwort (Passwort-Auth).
--timeout <ms>: RPC-Timeout.
--json: JSON-Ausgabe (empfohlen f\u00fcr Scripting).

Hinweis: Wenn du --url setzt, f\u00e4llt die CLI nicht auf Config- oder Umgebungs-Anmeldeinformationen zur\u00fcck. \u00dcbergib --token oder --password explizit. Fehlende explizite Anmeldeinformationen sind ein Fehler.

Hinweise

Token-Rotation gibt ein neues Token zur\u00fcck (sensibel). Behandle es wie ein Secret.
Diese Befehle erfordern den operator.pairing-Scope (oder operator.admin).
devices clear ist absichtlich durch --yes gesch\u00fctzt.
Wenn der Pairing-Scope auf dem lokalen Loopback nicht verf\u00fcgbar ist (und kein explizites --url \u00fcbergeben wurde), k\u00f6nnen list/approve einen lokalen Pairing-Fallback verwenden.

Token-Drift-Wiederherstellungs-Checkliste

Verwende dies, wenn die Control-UI oder andere Clients st\u00e4ndig mit AUTH_TOKEN_MISMATCH oder AUTH_DEVICE_TOKEN_MISMATCH fehlschlagen.

Aktuelle Gateway-Token-Quelle best\u00e4tigen:

openclaw config get gateway.auth.token

Gekoppelte Ger\u00e4te auflisten und die betroffene Ger\u00e4te-ID identifizieren:

openclaw devices list

Operator-Token f\u00fcr das betroffene Ger\u00e4t rotieren:

openclaw devices rotate --device <deviceId> --role operator

Wenn die Rotation nicht ausreicht, veraltetes Pairing entfernen und erneut genehmigen:

openclaw devices remove <deviceId>
openclaw devices list
openclaw devices approve <requestId>

Client-Verbindung mit dem aktuellen gemeinsamen Token/Passwort erneut versuchen.

Verwandte Themen: