Commandes CLI

devices

Gérez les demandes d'appairage de périphériques et les jetons limités aux périphériques.

Commandes

openclaw devices list

Lister les demandes d'appairage en attente et les périphériques appairés.

openclaw devices list
openclaw devices list --json

openclaw devices remove <deviceId>

Supprimer une entrée de périphérique appairé.

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

openclaw devices clear --yes [--pending]

Effacer les périphériques appairés en bloc.

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

openclaw devices approve [requestId] [--latest]

Approuver une demande d'appairage de périphérique en attente. Si requestId est omis, OpenClaw approuve automatiquement la demande en attente la plus récente.

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

openclaw devices reject <requestId>

Rejeter une demande d'appairage de périphérique en attente.

openclaw devices reject <requestId>

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

Faire tourner un jeton de périphérique pour un rôle spécifique (en mettant à jour les portées optionnellement).

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

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

Révoquer un jeton de périphérique pour un rôle spécifique.

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

Options communes

  • --url <url>: URL WebSocket de la passerelle (par défaut gateway.remote.url si configuré).
  • --token <token>: Jeton de la passerelle (si requis).
  • --password <password>: Mot de passe de la passerelle (authentification par mot de passe).
  • --timeout <ms>: Délai d'expiration RPC.
  • --json: Sortie JSON (recommandée pour les scripts).

Note : lorsque vous définissez --url, le CLI ne revient pas aux identifiants de configuration ou d'environnement. Passez --token ou --password explicitement. L'absence d'identifiants explicites est une erreur.

Notes

  • La rotation de jeton retourne un nouveau jeton (sensible). Traitez-le comme un secret.
  • Ces commandes nécessitent la portée operator.pairing (ou operator.admin).
  • devices clear est intentionnellement protégé par --yes.
  • Si la portée d'appairage n'est pas disponible en boucle locale (et qu'aucun --url explicite n'est passé), list/approve peut utiliser un secours d'appairage local.

dashboarddirectory