JWS.Консоль ↗
Разделы документации

JWS Agent и CLI

Зачем нужен JWS Agent

JWS Agent передаёт в консоль показатели изнутри сервера: загрузку CPU, использованную и доступную память, заполнение файловых систем, дисковый и сетевой обмен. В Monitoring также доступны процессы, состояния служб и контейнеров, если эти данные можно получить на сервере. Так видно, чем заняты ресурсы и где заканчивается место, а не только сколько CPU, памяти и диска выделено VM.

Свежие показатели агента используются в обзоре сервера и Monitoring. Графики и поиск процессов описаны в разделе мониторинга. Если отчёты перестали поступать, JWS отмечает это и использует доступные показатели виртуализации; отсутствующее значение не становится нулём. В Alerts можно настроить правила предупреждений по доступным метрикам. Для доставки уведомлений подключите Notifications.

При включённом JWS Agent на поддерживаемой Ubuntu VM автоматически устанавливается и CLI jws. С ним приложение или отдельно установленный ИИ-агент может:

  • Запросить ключ через Secrets и сохранить его в защищённый .env в пределах выданных этому серверу прав.
  • Работать с AI Mail после привязки ящика к существующему агенту OpenClaw. Привязку и право автоматической отправки задаёт владелец.
  • Использовать AI Bridge с удостоверением VM, без отдельного AI API key. Расход оплачивается с баланса владельца сервера.

Сам JWS Agent собирает статистику и не является ИИ-помощником. Он не устанавливает OpenClaw, не меняет его модель и не запускает беседы. Сборщик не передаёт содержимое файлов, журналы приложений, переменные окружения или аргументы запуска процессов.

Автоматическая установка рассчитана на управляемые Ubuntu VM JWS. На управляемой Windows VM автоматическая установка CLI и сборщик внутренних метрик пока не поддерживаются. Для своего Windows-компьютера доступны установочная команда и самостоятельная сборка CLI; ограничения проверки Windows описаны ниже. Метрики виртуализации остаются доступны без агента.

На серверах JWS

При включённом JWS agent JWS автоматически устанавливает jws и удостоверение сервера на новые готовые Ubuntu VM. Существующие готовые серверы также проверяются. Установка Node.js, npm или Go для CLI не нужна.

Новые выпуски устанавливаются автоматически после их публикации в системе JWS. Проверка проходит примерно раз в минуту, когда очередь управления свободна. Если сервер выключен или недоступен, обновление повторяется после его запуска и восстановления связи.

Обновление сохраняет удостоверение, проектные файлы, .env и программы сервера. Оно не обновляет установленный вами OpenClaw или его Node.js. Проверить выпуск:

jws version
jws help

Скачать самостоятельную сборку

Доступны исполняемые файлы x64 и ARM64. Выберите архитектуру своего компьютера:

Системаx64 / amd64ARM64
Ubuntu / Linuxjws-linux-amd64jws-linux-arm64
Windowsjws-windows-amd64.exejws-windows-arm64.exe

Размеры, SHA-256 и версия опубликованы в манифесте выпуска. Сравните хеш скачанного файла с соответствующей записью. На Ubuntu это sha256sum имя-файла, в PowerShell Get-FileHash имя-файла -Algorithm SHA256.

Загрузка одного бинарника не связывает компьютер с аккаунтом. Для подключения используйте установочную команду JWS Agent из Secrets. Чужое удостоверение VM переносить не нужно.

Установка на свой хост

В Secrets → Install нажмите Get install command. Выберите систему и выполните скопированную команду от обычного пользователя. Установщик выбирает x64 или ARM64, проверяет SHA256 сборки и сохраняет идентичность только в защищённых файлах. Node.js для установки и команд CLI не нужен.

На Linux агент работает как пользовательская systemd-служба jws-host-agent.service; журнал доступен через journalctl --user -u jws-host-agent -f. На Windows установщик создаёт задачу входа пользователя. Нативное выполнение Windows ещё не проверено; автоматическая настройка OpenClaw поддерживается только на Linux с совместимой установленной версией.

jws agent status проверяет связь хоста с JWS. Хост автоматически появляется в Secrets → Install. Для AI отдельный ключ JWS не нужен; расходы относятся к вашему аккаунту. Mail начинает работать только после вашей привязки ящика к существующему агенту. Установка JWS Agent не создаёт OpenClaw, не меняет его модель и не запускает беседу.

Ручная установка CLI на Ubuntu

На управляемой VM ручная установка обычно не нужна. Для проверки скачанной сборки сохраните подходящий файл как jws в отдельном каталоге, выдайте право запуска и выполните:

chmod 755 ./jws
./jws version
./jws help

Не перезаписывайте управляемый бинарник без необходимости. Команды version и help работают без удостоверения; операции с ключами требуют удостоверения сервера либо явно разрешённого внешнего клиента.

Ручная установка на Windows

Скачайте подходящий .exe, сохраните его как jws.exe в отдельной папке и откройте PowerShell в ней:

.\jws.exe version
.\jws.exe help

Для ручного обновления загрузите новый проверенный файл и замените старый, когда CLI не запущен. Node.js не требуется. Для защиты секретных файлов CLI использует встроенный Windows PowerShell и проверку ACL; если защиту нельзя подтвердить, запись отклоняется. Для записи .env также нужен Git.

Автоматическое обновление управляемых VM рассчитано на Ubuntu; для внешних хостов доступен отдельный установщик JWS Agent. Сборки Windows опубликованы; защита Windows ACL пока не подтверждена прогоном на настоящей Windows. Это ограничение проверки, а не требование установить Node.js.

Инструкция для OpenClaw

На управляемой Ubuntu VM с установленным OpenClaw JWS добавляет собственную инструкцию jws-client в пользовательский каталог ~/.openclaw/skills/jws-client/SKILL.md. OpenClaw обнаруживает её как обычный пользовательский skill: в ней описаны команды Mail, Secrets и AI Bridge. Установка не меняет конфигурацию, модели или беседы и не запускает агента.

Если OpenClaw установлен после CLI, инструкция добавляется при следующей проверке. При отключённом JWS agent автоматическая установка CLI, инструкции и listener не выполняется. JWS сохраняет чужие skills и пользовательские изменения в своей инструкции.

После переноса своей установки OpenClaw на поддерживаемую Ubuntu VM выполните от её обычного пользователя:

jws mail help
jws mail status
jws mail install-skill

jws mail skill печатает встроенную инструкцию без авторизации и Node.js. Установщик использует существующий каталог OpenClaw внутри домашней папки пользователя; небезопасные ссылки и каталоги с общей записью отклоняются. Автоматическая установка skill на Windows пока не поддерживается; самостоятельные Mail-команды не требуют Node.js.

Команды

jws secrets list
jws secrets request API_KEY --purpose "Настройка приложения" --request-id app-key
jws secrets status REQUEST_ID
jws secrets save KEY_ID --env .env --var API_KEY
jws secrets rename KEY_ID NEW_NAME
jws secrets delete KEY_ID

REQUEST_ID берите из ответа на создание запроса: пользовательский --request-id служит для повторяемости, а статус принимает ID самой записи запроса. KEY_ID берите из списка ключей либо выполненного запроса. На Windows замените начальное jws на .\jws.exe, если файл не добавлен в PATH.

create NAME и set KEY_ID принимают значение через стандартный ввод, не через аргумент команды. Для обычной настройки агентом предпочтителен запрос владельцу, чтобы значение не попадало в переписку или историю команд.

По умолчанию CLI читает защищённое удостоверение из ~/.config/jws/machine.json. JWS_CONFIG_FILE выбирает другой защищённый файл, но не создаёт новую авторизацию. Если удостоверения на управляемой VM нет, это проблема установки, не повод переносить его на чужой компьютер.

Правила и примеры проверены 7 октября 2026. Актуальные цены и доступность приложений смотрите в консоли.