Команды CLI

devices

Управление запросами на сопряжение устройств и токенами с ограниченной областью действия устройства.

Команды

openclaw devices list

Вывести список ожидающих запросов на сопряжение и сопряженных устройств.

openclaw devices list
openclaw devices list --json

openclaw devices remove <deviceId>

Удалить одну запись о сопряженном устройстве.

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

openclaw devices clear --yes [--pending]

Массовое удаление сопряженных устройств.

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

openclaw devices approve [requestId] [--latest]

Одобрить ожидающий запрос на сопряжение устройства. Если requestId не указан, OpenClaw автоматически одобряет самый последний ожидающий запрос.

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

openclaw devices reject <requestId>

Отклонить ожидающий запрос на сопряжение устройства.

openclaw devices reject <requestId>

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

Обновить токен устройства для конкретной роли (с возможным обновлением областей действия).

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

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

Отозвать токен устройства для конкретной роли.

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

Общие параметры

  • --url <url>: URL WebSocket шлюза (по умолчанию используется gateway.remote.url, если настроен).
  • --token <token>: Токен шлюза (если требуется).
  • --password <password>: Пароль шлюза (аутентификация по паролю).
  • --timeout <ms>: Таймаут RPC.
  • --json: Вывод в формате JSON (рекомендуется для скриптов).

Примечание: при установке --url CLI не возвращается к учетным данным из конфигурации или переменных окружения. Передавайте --token или --password явно. Отсутствие явных учетных данных является ошибкой.

Примечания

  • Ротация токена возвращает новый токен (конфиденциальные данные). Обращайтесь с ним как с секретом.
  • Эти команды требуют область действия operator.pairing (или operator.admin).
  • Команда devices clear намеренно защищена флагом --yes.
  • Если область действия для сопряжения недоступна на локальном loopback-интерфейсе (и явный --url не передан), list/approve могут использовать локальный резервный механизм сопряжения.

Панель управленияСправочник