openclaw nodes

Управляйте связанными узлами (устройствами) и вызывайте возможности узлов.

Связанные разделы:

• Обзор узлов: Узлы
• Камера: Узлы камер
• Изображения: Узлы изображений

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

• --url, --token, --timeout, --json

Общие команды

openclaw nodes listopenclaw nodes list --connectedopenclaw nodes list --last-connected 24hopenclaw nodes pendingopenclaw nodes approve <requestId>openclaw nodes reject <requestId>openclaw nodes remove --node <id|name|ip>openclaw nodes rename --node <id|name|ip> --name <displayName>openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24h

nodes list выводит таблицы ожидающих и связанных узлов. Строки связанных узлов включают давность последнего подключения (Последнее подключение). Используйте --connected, чтобы показывать только узлы, подключенные в данный момент. Используйте --last-connected <duration>, чтобы отфильтровать узлы, подключавшиеся в течение указанного периода (например, 24h, 7d). Используйте nodes remove --node <id|name|ip>, чтобы удалить связь узла. Для узла, поддерживаемого устройством, это отзывает роль устройства node в devices/paired.json и отключает его сеансы с ролью узла (устройство со смешанными ролями сохраняет свою строку и теряет только роль node; устройство только с ролью узла удаляется); также очищается любая соответствующая устаревшая запись связи узла, принадлежащая Gateway. operator.pairing может удалять строки узлов без роли оператора; вызывающей стороне с токеном устройства, которая отзывает собственную роль узла на устройстве со смешанными ролями, дополнительно требуется operator.admin.

Примечание об одобрении:

• openclaw nodes pending требует только область действия для связывания.
• gateway.nodes.pairing.autoApproveCidrs может пропустить этап ожидания только для явно доверенного первичного связывания устройства с role: node. По умолчанию он отключен и не одобряет повышения уровня.
• openclaw nodes approve <requestId> наследует дополнительные требования к области действия из ожидающего запроса:
  • запрос без команд: только связывание
  • команды узла без exec: связывание + запись
  • system.run / system.run.prepare / system.which: связывание + администрирование

Вызов

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>

Флаги вызова:

• --params <json>: строка объекта JSON (по умолчанию {}).
• --invoke-timeout <ms>: тайм-аут вызова узла (по умолчанию 15000).
• --idempotency-key <key>: необязательный ключ идемпотентности.
• system.run и system.run.prepare здесь заблокированы; для выполнения команд оболочки используйте инструмент exec с host=node.

Для выполнения команд оболочки на узле используйте инструмент exec с host=node вместо openclaw nodes run. CLI nodes теперь ориентирован на возможности: прямой RPC через nodes invoke, а также связывание, камера, экран, местоположение, Canvas и уведомления. Команды Canvas реализованы встроенным экспериментальным плагином Canvas; ядро сохраняет хук совместимости, чтобы они оставались доступны в openclaw nodes canvas.

Связанные разделы

• Справочник CLI
• Узлы