Команды CLI

node

Запустите автономный узел, который подключается к WebSocket шлюза и предоставляет доступ к system.run / system.which на этой машине.

Зачем использовать узел?

Используйте узел, когда вы хотите, чтобы агенты выполняли команды на других машинах в вашей сети без установки полного приложения-компаньона для macOS. Типичные сценарии использования:

  • Выполнение команд на удаленных машинах Linux/Windows (серверы сборки, лабораторные машины, NAS).
  • Сохранение выполнения в песочнице на шлюзе, но делегирование утвержденных запусков другим хостам.
  • Предоставление легковесной, автономной цели для выполнения автоматизации или CI узлов.

Выполнение по-прежнему контролируется утверждениями выполнения и списками разрешений на узле для каждого агента, что позволяет сохранять доступ к командам ограниченным и явным.

Прокси браузера (нулевая конфигурация)

Узлы автоматически объявляют прокси браузера, если browser.enabled не отключен на узле. Это позволяет агенту использовать автоматизацию браузера на этом узле без дополнительной настройки. При необходимости отключите его на узле:

{
  nodeHost: {
    browserProxy: {
      enabled: false,
    },
  },
}

Запуск (в режиме реального времени)

openclaw node run --host <gateway-host> --port 18789

Параметры:

  • --host <host>: Хост WebSocket шлюза (по умолчанию: 127.0.0.1)
  • --port <port>: Порт WebSocket шлюза (по умолчанию: 18789)
  • --tls: Использовать TLS для подключения к шлюзу
  • --tls-fingerprint <sha256>: Ожидаемый отпечаток сертификата TLS (sha256)
  • --node-id <id>: Переопределить идентификатор узла (очищает токен сопряжения)
  • --display-name <name>: Переопределить отображаемое имя узла

Служба (фоновый режим)

Установите автономный узел как пользовательскую службу.

openclaw node install --host <gateway-host> --port 18789

Параметры:

  • --host <host>: Хост WebSocket шлюза (по умолчанию: 127.0.0.1)
  • --port <port>: Порт WebSocket шлюза (по умолчанию: 18789)
  • --tls: Использовать TLS для подключения к шлюзу
  • --tls-fingerprint <sha256>: Ожидаемый отпечаток сертификата TLS (sha256)
  • --node-id <id>: Переопределить идентификатор узла (очищает токен сопряжения)
  • --display-name <name>: Переопределить отображаемое имя узла
  • --runtime <runtime>: Среда выполнения службы (node или bun)
  • --force: Переустановить/перезаписать, если уже установлено

Управление службой:

openclaw node status
openclaw node stop
openclaw node restart
openclaw node uninstall

Используйте openclaw node run для узла в режиме реального времени (без службы). Команды службы принимают --json для машинно-читаемого вывода.

Сопряжение

Первое подключение создает ожидающий запрос на сопряжение устройства (role: node) на Шлюзе. Утвердите его с помощью:

openclaw devices list
openclaw devices approve <requestId>

Узел сохраняет свой идентификатор, токен, отображаемое имя и информацию о подключении к шлюзу в ~/.openclaw/node.json.

Утверждения выполнения

system.run контролируется локальными утверждениями выполнения:

modelsnodes