Comandos CLI

devices

Gestiona solicitudes de emparejamiento de dispositivos y tokens con alcance de dispositivo.

Comandos

openclaw devices list

Lista las solicitudes de emparejamiento pendientes y los dispositivos emparejados.

openclaw devices list
openclaw devices list --json

openclaw devices remove <deviceId>

Elimina una entrada de dispositivo emparejado.

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

openclaw devices clear --yes [--pending]

Limpia dispositivos emparejados de forma masiva.

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

openclaw devices approve [requestId] [--latest]

Aprueba una solicitud de emparejamiento de dispositivo pendiente. Si se omite requestId, OpenClaw aprueba automáticamente la solicitud pendiente más reciente.

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

openclaw devices reject <requestId>

Rechaza una solicitud de emparejamiento de dispositivo pendiente.

openclaw devices reject <requestId>

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

Rota un token de dispositivo para un rol específico (opcionalmente actualizando los alcances).

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

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

Revoca un token de dispositivo para un rol específico.

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

Opciones comunes

  • --url <url>: URL WebSocket del Gateway (por defecto gateway.remote.url cuando está configurado).
  • --token <token>: Token del Gateway (si es requerido).
  • --password <password>: Contraseña del Gateway (autenticación por contraseña).
  • --timeout <ms>: Tiempo de espera RPC.
  • --json: Salida JSON (recomendado para scripting).

Nota: cuando configuras --url, la CLI no recurre a las credenciales de configuración o entorno. Pasa --token o --password explícitamente. La falta de credenciales explícitas es un error.

Notas

  • La rotación de token devuelve un nuevo token (sensible). Trátalo como un secreto.
  • Estos comandos requieren el alcance operator.pairing (o operator.admin).
  • devices clear está intencionalmente protegido por --yes.
  • Si el alcance de emparejamiento no está disponible en el bucle local (y no se pasa un --url explícito), list/approve puede usar un respaldo de emparejamiento local.

dashboarddirectory