Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw devices
Керуйте запитами на сполучення пристроїв і токенами з областю дії пристрою.
Команди
openclaw devices list
Вивести список запитів на сполучення, що очікують, і сполучених пристроїв.
openclaw devices remove <deviceId>
Видалити один запис сполученого пристрою.
Коли ви автентифіковані токеном сполученого пристрою, викликачі без прав адміністратора можуть
видалити лише запис свого власного пристрою. Видалення іншого пристрою потребує
operator.admin.
openclaw devices clear --yes [--pending]
Масово очистити сполучені пристрої.
openclaw devices approve [requestId] [--latest]
Схвалити запит на сполучення пристрою, що очікує, за точним requestId. Якщо requestId
пропущено або передано --latest, OpenClaw лише виводить вибраний запит, що очікує,
і завершує роботу; повторно запустіть схвалення з точним ідентифікатором запиту після перевірки
деталей.
Якщо пристрій повторно намагається виконати сполучення зі зміненими даними автентифікації (роль, області дії або публічний ключ), OpenClaw замінює попередній запис, що очікує, і видає новий
requestId. Запустіть openclaw devices list безпосередньо перед схваленням, щоб використати поточний ідентифікатор.Requested і Approved в openclaw devices list
або використайте openclaw devices approve --latest, щоб попередньо переглянути точне підвищення перед
його схваленням.
Якщо Gateway явно налаштовано з
gateway.nodes.pairing.autoApproveCidrs, перші запити role: node від
відповідних IP-адрес клієнтів можуть бути схвалені до появи в цьому списку. Ця політика
типово вимкнена й ніколи не застосовується до клієнтів operator/browser або запитів
на підвищення.
openclaw devices reject <requestId>
Відхилити запит на сполучення пристрою, що очікує.
openclaw devices rotate --device <id> --role <role> [--scope <scope...>]
Оновити токен пристрою для певної ролі (за потреби оновивши області дії).
Цільова роль уже має існувати в схваленому контракті сполучення цього пристрою;
оновлення не може створити нову несхвалену роль.
Якщо ви пропустите --scope, подальші повторні підключення зі збереженим оновленим токеном повторно використовуватимуть
кешовані схвалені області дії цього токена. Якщо передати явні значення --scope, вони
стануть збереженим набором областей дії для майбутніх повторних підключень із кешованим токеном.
Викликачі зі сполученим пристроєм без прав адміністратора можуть оновлювати лише токен свого власного пристрою.
Цільовий набір областей дії токена має залишатися в межах власних operator
областей дії сеансу викликача; оновлення не може створити або зберегти ширший operator токен, ніж той,
який уже має викликач.
openclaw devices revoke --device <id> --role <role>
Відкликати токен пристрою для певної ролі.
Викликачі зі сполученим пристроєм без прав адміністратора можуть відкликати лише токен свого власного пристрою.
Відкликання токена іншого пристрою потребує operator.admin.
Цільовий набір областей дії токена також має вкладатися у власні operator
області дії сеансу викликача; викликачі лише зі сполученням не можуть відкликати admin/write operator токени.
Поширені параметри
--url <url>: URL WebSocket Gateway (типовоgateway.remote.url, якщо налаштовано).--token <token>: токен Gateway (якщо потрібен).--password <password>: пароль Gateway (автентифікація паролем).--timeout <ms>: тайм-аут RPC.--json: вивід JSON (рекомендовано для сценаріїв).
Примітки
- Оновлення токена повертає новий токен (чутливі дані). Поводьтеся з ним як із секретом.
- Ці команди потребують області дії
operator.pairing(абоoperator.admin). Деякі схвалення також потребують, щоб викликач мав operator області дії, які цільовий пристрій створив би або успадкував би; див. Operator scopes. gateway.nodes.pairing.autoApproveCidrs— це opt-in політика Gateway лише для нового сполучення пристрою node; вона не змінює повноваження CLI на схвалення.- Оновлення та відкликання токенів залишаються в межах схваленого набору ролей сполучення й схваленої базової області дії для цього пристрою. Випадковий запис кешованого токена не надає ціль для керування токенами.
- Для сеансів із токенами сполучених пристроїв міжпристроєве керування доступне лише адміністраторам:
remove,rotateіrevokeдіють лише на власний пристрій, якщо викликач не маєoperator.admin. - Зміна токена також обмежена областями дії викликача: сеанс лише зі сполученням не може
оновити або відкликати токен, який зараз має
operator.adminабоoperator.write. devices clearнавмисно захищено прапорцем--yes.- Якщо область дії сполучення недоступна на local loopback (і не передано явний
--url), list/approve можуть використати локальний резервний механізм сполучення. devices approveпотребує явного ідентифікатора запиту перед створенням токенів; пропускrequestIdабо передавання--latestлише попередньо показує найновіший запит, що очікує.
Контрольний список відновлення після розсинхронізації токенів
Використовуйте це, коли Control UI або інші клієнти продовжують відмовляти зAUTH_TOKEN_MISMATCH, AUTH_DEVICE_TOKEN_MISMATCH або AUTH_SCOPE_MISMATCH.
- Підтвердьте поточне джерело токена gateway:
- Виведіть список сполучених пристроїв і визначте ідентифікатор ураженого пристрою:
- Оновіть operator токен для ураженого пристрою:
- Якщо оновлення недостатньо, видаліть застаріле сполучення й схваліть знову:
- Повторіть підключення клієнта з поточним спільним токеном/паролем.
- Звичайний пріоритет автентифікації під час повторного підключення: спершу явний спільний токен/пароль, потім явний
deviceToken, потім збережений токен пристрою, потім bootstrap token. - Довірене відновлення
AUTH_TOKEN_MISMATCHможе тимчасово надіслати і спільний токен, і збережений токен пристрою разом для однієї обмеженої повторної спроби. AUTH_SCOPE_MISMATCHозначає, що токен пристрою було розпізнано, але він не містить запитаного набору областей дії; виправте контракт схвалення сполучення/областей дії перед зміною спільної автентифікації gateway.