Перейти к основному содержимому

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

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

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

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

Параметры:

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