Как использовать OpenClaw
Практическое руководство, чтобы получить максимум от автономного ИИ-агента RoqueOS.
Интерфейс агента
Приложение AI Agent разделено на две основные области:
- Панель чата (слева) — здесь вы отправляете сообщения и следите за ответами
- Просмотр рабочего стола (справа) — прямая трансляция того, что агент делает в контейнере
Панель шагов
Под чатом находится панель Шагов в реальном времени, которая показывает каждое действие, выполняемое агентом: переход по URL-адресу, клик по элементу, выполнение команды и т.д.
Создание сессии
Каждый разговор с агентом создает сессию — изолированный Docker-контейнер с выделенным рабочим столом Linux. Чтобы начать:
- Откройте приложение AI Agent в Launchpad.
- Нажмите Новая сессия (New Session).
- Контейнер начнет инициализацию (в первый раз это может занять 10–30 секунд).
- Когда на правой панели появится рабочий стол, агент готов к работе.
Отправка задач
Лучшие практики для промптов (запросов)
Будьте конкретны и объективны при описании задачи. Чем больше контекста вы предоставите, тем лучше будет результат.
❌ Размыто:
Найди информацию о Docker✅ Конкретно:
Изучи топ-5 отличий между Docker Compose v2 и v3,
создай markdown-файл с кратким изложением этих пунктов и сохрани его в /home/user/docker-comparison.mdПримеры задач
Исследования и документация:
Зайди на сайт hetzner.com, найди доступные тарифы VPS
и создай сравнительную таблицу с ценами и характеристиками в формате CSV.Автоматизация форм:
Заполни форму регистрации на [URL] следующими данными:
имя: Иван Иванов, email: ivan@example.com, тариф: базовыйРазработка:
Создай Python-скрипт, который парсит заголовки новостей
с Hacker News и сохраняет топ-10 в файл JSON.Анализ сайтов:
Зайди в этот репозиторий на GitHub [URL], прочитай README и объясни
мне, что делает этот проект и какие у него предварительные требования для установки.Действия, которые агент может выполнять в RoqueOS
OpenClaw может напрямую взаимодействовать с вашим RoqueOS за пределами изолированного контейнера:
| Действие | Описание |
|---|---|
| Уведомление | Отправить оповещение на ваш рабочий стол RoqueOS |
| Открыть приложение | Открыть конкретное приложение в Launchpad |
| Открыть URL | Открыть ссылку в браузере RoqueOS |
Пример использования: по завершении длительной задачи агент может отправить автоматическое уведомление, чтобы сообщить вам, что он закончил.
Управление сессиями
Активные сессии
Все активные сессии отображаются в верхней части приложения. Вы можете:
- Возобновить (Resume) предыдущую сессию, кликнув по ней
- Завершить (End) сессию, чтобы освободить ресурсы сервера
Лимит одновременных сессий
По умолчанию сервер разрешает до 3 одновременных сессий (настраивается через AGENT_MAX_SESSIONS). Завершайте сессии, которые вы больше не используете, чтобы сэкономить оперативную память (RAM).
Скриншоты и полноэкранный режим
- Скриншот — нажмите на значок камеры, чтобы зафиксировать текущее состояние рабочего стола агента
- Полный экран — разверните просмотр рабочего стола на весь экран, чтобы лучше следить за визуальными задачами
Известные ограничения
- Агент работает в изолированной среде — он не имеет прямого доступа к вашим локальным файлам, если вы не предоставите эту информацию через чат.
- Задачи, требующие входа в аккаунты (электронная почта, социальные сети), требуют от вас предоставления учетных данных во время разговора.
- Тайм-аут по умолчанию составляет 30 минут бездействия — очень долгие задачи могут потребовать периодического взаимодействия.
Устранение неполадок
Агент не отвечает
- Проверьте, в сети ли сервер:
curl http://localhost:27021/health - Убедитесь, что API ключ настроен правильно.
- Завершите текущую сессию и создайте новую.
Рабочий стол не появляется на панели
Возможно, контейнер все еще инициализируется. Подождите 30 секунд и перезагрузите приложение.
Медленные или неполные ответы
Это может быть связано с ограничениями на количество запросов (rate limit) от ИИ-провайдера. Подождите немного и попробуйте снова, или уменьшите сложность задачи.