AI-агент — RoqueClaw
"Установи Plex на сервер", "Открой терминал и покажи использование диска", "Изучи сегодняшний Hacker News и сгенерируй конспект в Notes"
RoqueClaw (основан на OpenClaw) — это автономный оператор вашего RoqueOS. В отличие от чат-бота, который только отвечает текстом, он выполняет реальные действия на вашем сервере и рабочем столе: устанавливает контейнеры, открывает приложения, пишет файлы, запускает уведомления, навигирует по сети, выполняет команды в терминале.
Практическая разница? Вы говорите "мне нужен медиа-сервер", и он устанавливает Jellyfin, настраивает его, открывает в браузере и уведомляет, когда готов. Вместо того, чтобы открывать 5 вкладок, читать туториал и следовать 20 шагам.
Что он умеет
🐳 Устанавливать Docker-контейнеры через естественный язык
вы: "Установи Nextcloud для меня, с 2GB RAM"
RoqueClaw: ✓ Устанавливаю nextcloud:latest...
✓ Настраиваю 2GB RAM и постоянный том
✓ Контейнер поднялся на порту 8080
✓ Я открыл его в вашем браузере. Начальный логин: admin/adminПод капотом он использует roqueos-cli, предустановленный на сервере (см. раздел ниже), чтобы вызвать API RoqueOS Server. Тот же App Store, тот же каталог, тот же installApp(appId, config) — только запускается естественным языком вместо клика.
💻 Работать на вашем рабочем столе
- Открывает конкретные приложения (
Открой Finder,Открой VS Code,Открой браузер на google.com) - Создаёт файлы в Files (
Сохрани этот конспект как /home/user/notes/reuniao.md) - Отправляет уведомления (
Уведоми меня, когда бэкап закончится) - Показывает диалоги (
Спроси пользователя, одобряет ли он этот шаг, прежде чем продолжать)
🌐 Навигировать и автоматизировать веб
- Открывает Chromium внутри изолированного контейнера (не в вашем браузере — безопасность)
- Скрейпинг, заполнение форм, скачивание файлов
- Делает скриншоты, чтобы вы могли визуально отслеживать прогресс
🤖 Выполнять сложные многошаговые задачи
Это не одиночный промпт → одиночный ответ. Это автономный цикл:
- Вы описываете цель
- RoqueClaw планирует шаги
- Выполняет каждый шаг (вы видите вживую через VNC)
- Если что-то идёт не так, корректирует и повторяет попытку
- В конце резюмирует выполненное + действия, которые он предпринял
Архитектура
3 слоя:
- Frontend: Чат + живая визуализация рабочего стола через noVNC
- Backend: Управляет сессиями, контейнерами и потоком сообщений/шагов. Экспонирует
/agent/actions/*эндпоинты, которые получают команды от CLI и запускают действия на подключённом фронтенде. - Контейнер RoqueClaw: Ubuntu 22.04 + XFCE + VNC + Chromium + Node.js + OpenClaw +
roqueos-cliпредустановлен для callback на сервер.
🔧 CLI roqueos-cli (мощь агента, и ваша тоже)
roqueos-cli — это канал между агентом и RoqueOS Server. Он предустановлен в двух местах:
| Где | Кто использует |
|---|---|
Контейнер RoqueClaw (/usr/local/bin/roqueos-cli) | Агент вызывает через subprocess при выполнении своих действий |
| Контейнер приложения Terminal (каждый пользователь сервера имеет свой) | Вы, через shell, всякий раз, когда нужно — даже без агента |
Это означает, что вы также можете использовать CLI напрямую, без участия агента. Откройте приложение Terminal, введите roqueos-cli ..., готово.
Доступные команды
Полный справочник смотрите, запустив roqueos-cli --help в приложении Terminal — это источник истины. 6 канонических действий:
roqueos-cli notify <title> <message> # Уведомление на рабочем столе RoqueOS
roqueos-cli open-app <appId> # Открыть приложение (finder, vscode, browser и др.)
roqueos-cli open-url <url> # Открыть URL в Roque Browser
roqueos-cli create-file <path> # Создать файл, читая контент из stdin
roqueos-cli run-terminal <command> # Выполнить команду + вернуть stdout
roqueos-cli show-dialog <message> [--type X] # Модал confirm/alert/infoПрактические примеры:
# Отправить уведомление на ваш рабочий стол RoqueOS
roqueos-cli notify "Бэкап завершён" "23 ГБ синхронизировано с Cloudflare R2"
# Открыть конкретное приложение
roqueos-cli open-app finder
# Открыть URL в браузере
roqueos-cli open-url "https://github.com/roqueribeiro"
# Создать/записать файл (читает stdin)
echo "Заметки совещания..." | roqueos-cli create-file "/home/user/notes/reuniao.md"
# Выполнить команду + получить результат как уведомление
roqueos-cli run-terminal "df -h"
# Модал подтверждения (ждёт ответа пользователя, прежде чем продолжить)
roqueos-cli show-dialog "Удалить 50GB старых логов?" --type confirmСинтаксис использует позиционные аргументы (не флаги
--title/--message). Если ваша версия CLI отличается, обновите черезapt-get install --reinstall roqueos-cliвнутри контейнера.
Реальные случаи использования
Cron-скрипт, который уведомляет при определённых событиях:
# Crontab, выполняемый ежедневно, уведомляет вас об использовании диска
0 9 * * * df -h | grep -E '^/' | awk '$5+0 > 80 {print $6, $5}' | \
xargs -I {} roqueos-cli notify "Диск почти полон" "{}"Деплой-workflow:
# Скрипт сборки, открывающий лог в VS Code по завершении
yarn build && roqueos-cli open-app vscode && \
roqueos-cli notify "Сборка OK" "Проверьте лог в /tmp/build.log"Интеграция с другими контейнерами:
# Задача внутри другого контейнера (например, Plex транскодирование) уведомляет пользователя
roqueos-cli notify "Plex" "Транскод 4K завершён. Фильм готов."HTTP API под капотом задокументирован в 75-agent-module.md (внутреннее правило сервера), раздел "Actions". Те же действия, что и фронтенд использует через WebSocket — notify, open-app, open-url, create-file, run-terminal, show-dialog.
Поддерживаемые AI-модели
RoqueClaw работает с основными провайдерами LLM:
| Провайдер | Рекомендуемые модели | Конфигурация |
|---|---|---|
| OpenAI | GPT-4o, GPT-4-turbo | OPENAI_API_KEY env var в контейнере |
| Anthropic | Claude 3.5 Sonnet, Claude 4.6 Sonnet | ANTHROPIC_API_KEY env var |
Выбор модели влияет на скорость и качество действий. Для сложной веб-автоматизации Claude Sonnet 4.6 или GPT-4o обычно имеют лучший визуальный контроль через VNC.
Реальные случаи использования
| Сценарий | Задача | Результат |
|---|---|---|
| Настройка нового сервера | "Установи Plex, qBittorrent и Sonarr, настрой их работать вместе" | 3 контейнера подняты + взаимосвязаны за ~3 мин |
| Исследование | "Изучи топ-5 JS-фреймворков 2026 года и сгенерируй сравнительную статью в Notes" | MD-статья сохранена в /home/user/notes/ + открыта в Finder |
| Диагностика | "Проверь, почему сервер тормозит" | Запустит top, df, free, docker stats — сгенерирует отчёт в Notes |
| Автоматизация | "Скачай вчерашний бэкап с Google Drive и распакуй в /data" | OAuth логин + скачивание + извлечение через tar |
| Разработка | "Создай Python-скрипт, мониторящий мой API и уведомляющий, если упадёт" | Скрипт сохранён в /home/user/projects/ + cron настроен |
| Умный дом | "Подключись к Home Assistant и покажи мне, какие лампы включены" | Живой список + опция выключить через чат |
Следующие шаги
- Конфигурация — Как установить и включить RoqueClaw (флаг
--with-roqueclawв установщике) - Как использовать — Пошаговый туториал + лучшие практики промптов + полные команды CLI