Как использовать OpenClaw
Практическое руководство, чтобы максимально использовать автономный AI-агент RoqueOS.
Интерфейс Агента
Приложение AI-агента разделено на две основные области:
- Панель Чата (слева) — где вы отправляете сообщения и отслеживаете ответы
- Визуализация Рабочего стола (справа) — прямая трансляция того, что агент делает в контейнере
Панель Steps
Под чатом панель Steps в реальном времени показывает каждое действие, выполняемое агентом: переход по URL, клик по элементу, выполнение команды и т.д.
Создание Сессии
Каждый разговор с агентом создаёт сессию — изолированный Docker-контейнер с эксклюзивным Linux-рабочим столом. Чтобы начать:
- Откройте приложение AI-агент в Launchpad.
- Нажмите Новая Сессия.
- Контейнер будет инициализирован (может занять 10-30 секунд в первый раз).
- Когда рабочий стол появится на правой панели, агент готов.
Отправка Задач
Лучшие Практики для Промптов
Будьте конкретны и объективны при описании задачи. Чем больше контекста вы предоставите, тем лучше результат.
❌ Расплывчато:
Изучите Docker✅ Конкретно:
Изучите 5 главных различий между Docker Compose v2 и v3,
создайте markdown-файл с обобщением ключевых моментов и сохраните в /home/user/docker-comparison.mdПримеры Задач
Исследование и документация:
Перейдите на сайт hetzner.com, найдите доступные планы VPS
и создайте сравнительную таблицу с ценами и ресурсами в CSV.Автоматизация форм:
Заполните регистрационную форму на [URL] следующими данными:
имя: João Silva, email: joao@exemplo.com, план: базовыйРазработка:
Создайте Python-скрипт, который скрейпит заголовки новостей
с Hacker News и сохраняет первые 10 в JSON-файл.Анализ сайтов:
Перейдите в этот GitHub-репозиторий [URL], прочитайте README и объясните мне,
что делает проект и каковы предварительные условия установки.Действия, которые агент выполняет в вашем RoqueOS
RoqueClaw не застревает в изолированном контейнере — он действует напрямую на вашем рабочем столе RoqueOS через CLI roqueos-cli, который предустановлен в контейнере агента И в контейнере Terminal-приложения каждого пользователя сервера.
6 канонических действий
| Команда CLI | Что делает | Пример промпта, который запускает |
|---|---|---|
roqueos-cli notify "title" "msg" | Уведомление на вашем рабочем столе | "Уведомите меня, когда закончится" |
roqueos-cli open-app <id> | Открывает приложение в Launchpad | "Откройте VS Code" |
roqueos-cli open-url <url> | Открывает URL в Roque Browser | "Откройте GitHub проекта" |
roqueos-cli create-file <path> | Записывает файл (читает stdin) | "Сохраните этот конспект в Notes" |
roqueos-cli run-terminal <cmd> | Выполняет команду + возвращает вывод | "Покажите, сколько свободного диска" |
roqueos-cli show-dialog "msg" | Модал подтверждения (пауза, ожидает) | "Спросите перед удалением" |
Вы также можете использовать CLI напрямую (без агента)
CLI доступен в приложении Terminal каждого пользователя (изолированный Ubuntu-контейнер). Откройте Terminal в Launchpad, введите roqueos-cli --help и используйте напрямую.
Распространённые случаи использования:
# Быстрое уведомление от скрипта резервного копирования
./backup.sh && roqueos-cli notify "Бэкап OK" "23 ГБ синхронизировано"
# Открыть VS Code прямо из shell, когда сборка закончится
yarn build && roqueos-cli open-app vscode
# Cron, который предупреждает, когда диск превышает 80%
0 9 * * * df -h | awk '$5+0 > 80 {system("roqueos-cli notify \"Диск полон\" \"" $6 " " $5 "\"")}'
# Python-скрипт пишет напрямую в файлы пользователя
echo "$(date): meeting notes" | roqueos-cli create-file "/home/user/notes/reuniao-$(date +%F).md"
# Plex-контейнер уведомляет, когда транскод закончится
# (внутри Plex-контейнера, если разделяет сеть roqueos-server)
roqueos-cli notify "Plex" "4K транскод фильма X завершён"Установка контейнеров через естественный язык (скрытая сила)
Самое используемое действие агента: установка Docker-приложений напрямую из каталога через roqueos-cli → API сервера → appsService.installApp.
Вы говорите: "Установите Nextcloud, 2GB RAM, и откройте, когда будет готов"
Агент делает (вы видите вживую через VNC):
- Идентифицирует
nextcloudв каталоге - Вызывает
roqueos-cli→ POST/apps/installсappId: nextcloud, memory: 2048 - Ожидает запуск контейнера + healthcheck
- Вызывает
roqueos-cli open-url http://localhost:<назначенный_порт> - Уведомляет "Nextcloud готов, начальный логин admin/admin"
Тот же API, что и визуальный App Store — только без необходимости навигации/клика. Полезно для:
- Массовая настройка: "Установите Plex, Sonarr, Radarr, Bazarr и qBittorrent. Настройте все, чтобы использовать хранилище
/media." - Целый стек: "Поднимите LAMP-стек с MariaDB и phpMyAdmin"
- Восстановление: "Переустановите все приложения, которые у меня были до краша"
Управление Сессиями
Активные Сессии
Все активные сессии перечислены в верхней части приложения. Вы можете:
- Возобновить предыдущую сессию, кликнув на неё
- Завершить сессию, чтобы освободить ресурсы сервера
Лимит Одновременных Сессий
По умолчанию сервер позволяет до 3 одновременных сессий (настраивается через AGENT_MAX_SESSIONS). Завершайте сессии, которые больше не используете, чтобы экономить RAM.
Скриншот и Полноэкранный режим
- Скриншот — нажмите на иконку камеры, чтобы захватить текущее состояние рабочего стола агента
- Полноэкранный режим — расширьте визуализацию рабочего стола на полный экран, чтобы лучше отслеживать визуальные задачи
Известные Ограничения
- Агент работает в изолированной среде — не имеет прямого доступа к вашим локальным файлам, если только вы не предоставляете информацию через чат
- Задачи, требующие входа в аккаунты (email, соцсети), требуют от вас предоставления учётных данных во время разговора
- Тайм-аут по умолчанию — 30 минут неактивности — очень длинные задачи могут потребовать периодического взаимодействия
Устранение Неполадок
Агент не отвечает
- Проверьте, что сервер онлайн:
curl http://localhost:27021/health - Подтвердите, что API-ключ настроен правильно
- Завершите текущую сессию и создайте новую
Рабочий стол не появляется на панели
Контейнер может всё ещё инициализироваться. Подождите 30 секунд и перезагрузите приложение.
Медленные или неполные ответы
Это может быть проблема rate limit AI-провайдера. Подождите несколько мгновений и попробуйте снова, или уменьшите сложность задачи.