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 / amd64 | ARM64 |
|---|---|---|
| Ubuntu / Linux | jws-linux-amd64 | jws-linux-arm64 |
| Windows | jws-windows-amd64.exe | jws-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 нет, это проблема установки, не повод переносить его на чужой компьютер.