`openclaw devices`

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

Comandos

`openclaw devices list`

Lista solicitudes de emparejamiento pendientes y 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 en bloque.

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 scopes).

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>: timeout de RPC.
--json: salida JSON (recomendado para scripting).

Nota: cuando estableces --url, el CLI no recurre a 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 tokens devuelve un nuevo token (sensible). Trátalo como un secreto.
Estos comandos requieren el scope operator.pairing (u operator.admin).
devices clear está intencionalmente protegido por --yes.
Si el scope de emparejamiento no está disponible en loopback local (y no se pasa un --url explícito), list/approve puede usar un fallback de emparejamiento local.

Lista de verificación de recuperación de deriva de token

Usa esto cuando la interfaz de Control u otros clientes sigan fallando con AUTH_TOKEN_MISMATCH o AUTH_DEVICE_TOKEN_MISMATCH.

Confirma la fuente actual del token del gateway:

openclaw config get gateway.auth.token

Lista dispositivos emparejados e identifica el id del dispositivo afectado:

openclaw devices list

Rota el token de operador para el dispositivo afectado:

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

Si la rotación no es suficiente, elimina el emparejamiento obsoleto y aprueba de nuevo:

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

Reintenta la conexión del cliente con el token/contraseña compartido actual.

Relacionado: