Самый простой способ пощупать OpenClaw через VirtualBox
Источник: habr.com — OpenClaw_Lab
После бума люди побежали устанавливать OpenClaw на сервер, Mac mini, на всё что угодно.
Но, кажется, мы забыли о старой доброй виртуалке, которую любой может поставить и настроить OpenClaw за несколько минут.
Разберём, какие есть плюсы:
- Бесплатно
- Полный контроль и безопасная среда
- Есть графический интерфейс и лёгкая автоматизация браузера
- Доступ к Dashboard, к которому сложнее получить доступ при установке на сервере
Минусы:
- ПК должен быть включён
- Вероятно, потребуется проксификация трафика (VPN), чтобы из РФ был доступ ко всем сервисам
Что потребуется для установки:
Установка
Нажимаем «Создать». Здесь важно указать ISO-образ Ubuntu.
После чего запускаем, со всем соглашаемся и обновляем систему:
sudo apt update && sudo apt upgrade
Дальше прописываем одну команду для установки OpenClaw:
curl -fsSL https://openclaw.ai/install.sh | bash
Вы сразу пройдёте onboarding, где сможете выбрать, какие skills и hooks установить сразу.
Например, Whisper — чтобы OpenClaw мог обрабатывать голосовые сообщения. Это правда удобно — приучайте себя записывать голосовое.
Проверка установки
Первое, что вам необходимо ввести в терминал:
openclaw status
Он выведет общую информацию о состоянии системы. Обратите внимание на Security audit — всё что critical необходимо исправить сразу.
Полезная команда для исправления ошибок настройки:
openclaw doctor
Одна из прекрасных функций — агент сам модифицирует себя и может настраивать свои конфиги.
Где живёт «душа» агента
Всё живёт в одной папке:
~/.openclaw/
openclaw.json — главный конфиг
Формат JSON5 (можно писать комментарии и ставить висячие запятые).
Здесь настраивается вообще всё:
- Какую модель использовать (Claude, GPT, Gemini, локальные)
- Fallback-модели, если основная недоступна
- Каналы связи: WhatsApp, Telegram, Discord, Slack и другие
- Gateway: порт, привязка, авторизация
- Sandbox: песочница для групповых сессий
- Heartbeat: как часто агент «просыпается» и проверяет задачи
- Skills: какие скиллы включены и их настройки
Минимальный конфиг — это буквально одна строчка с моделью. Если что-то сломали — бэкап в openclaw.json.bak. Совсем всё плохо — openclaw doctor --fix.
.env — переменные окружения
Лежит в ~/.openclaw/.env. Сюда кладём API-ключи: ANTHROPIC_API_KEY, OPENAI_API_KEY и прочие. Ссылаться из openclaw.json через ${VAR}.
credentials/ — ключи провайдеров
Отдельные файлы для openrouter, anthropic, synthetic и т.д. Обязательно закрывайте права доступа.
Рабочее пространство — ~/.openclaw/workspace/
Именно здесь живёт «душа» вашего агента. Все эти файлы — обычный Markdown, который автоматически инжектится в системный промпт при каждой сессии.
| Файл | Назначение |
|---|---|
AGENTS.md |
Рабочая инструкция: поведение, память, правила для групповых чатов |
SOUL.md |
Душа: персональность, тон, границы, стиль общения |
USER.md |
Информация о вас: предпочтения, стиль работы, контекст |
IDENTITY.md |
Визитка агента: имя, эмодзи, тема |
TOOLS.md |
Заметки об инструментах и особенностях окружения |
HEARTBEAT.md |
Чек-лист для периодических проверок |
BOOT.md |
Чек-лист при старте сессии |
SHIELD.md |
Политика безопасности (опционально) |
MEMORY.md |
Долгосрочная память — только в основной DM-сессии |
memory/YYYY-MM-DD.md |
Ежедневные логи, пишутся при компакции |
skills/<name>/SKILL.md |
Скиллы — папка с инструкциями |
cron/jobs.json |
Расписание задач |
Это просто файлы. Редактируйте чем угодно, версионируйте в Git, ищите через Obsidian. Агент сам подхватит изменения.
А можете вообще не трогать файлы руками — просто попросите агента изменить себя:
«Измени SOUL.md так, чтобы ты общался со мной на русском, был краток и по делу»
Dashboard
openclaw dashboard
Откроется веб-интерфейс прямо в браузере. Там можно смотреть состояние агента, сессии, логи, управлять каналами.
На сервере без графического интерфейса к нему сложнее получить доступ — нужно пробрасывать порты через SSH-туннель. А на виртуалке — просто открыли браузер, и всё работает.
Мульти-агенты
Можно создать несколько агентов. Каждый со своей личностью, своей моделью, своим workspace.
Например:
- Один агент для работы: строгий, на английском, с доступом к рабочим чатам
- Второй — для личного: на русском, более расслабленный
У каждого будут свои AGENTS.md, SOUL.md, USER.md. Своя память. Свои сессии.
openclaw agents add <имя>
openclaw agents list --bindings
Переключаться между ними в чате можно через /agent <id>. Каждый агент можно привязать к конкретному каналу — рабочий в Slack, личный в Telegram.
Sandbox
Важная штука, если планируете использовать агента не только для себя.
По умолчанию в основной сессии агент имеет полный доступ к системе. Если подключаете групповые чаты или даёте доступ другим людям — любой участник может попросить агента выполнить команду на вашей машине. Это опасно.
Включается в openclaw.json:
agents.defaults.sandbox.mode: "non-main"
После этого все сессии кроме вашей основной выполняются в Docker-песочнице. Есть allowlist и denylist инструментов. По умолчанию разрешены: чтение, запись, редактирование файлов, bash. Заблокированы: браузер, cron, gateway.
Память и компакция
У каждой модели есть лимит контекста. Когда переписка становится длинной, агент начинает упираться в этот лимит.
Для этого есть компакция. Когда контекст доходит до определённого порога (по умолчанию 40k токенов), агент сжимает всю сессию и записывает самое важное в memory/YYYY-MM-DD.md.
Что именно он запомнит, зависит от flush prompt — инструкция, которая говорит агенту на что обращать внимание: решения, изменения состояния, уроки — а не рутинную болтовню. Если ничего важного не произошло — напишет NO_FLUSH и ничего не сохранит.
Ещё есть режим cache-ttl — держит кэш промпта валидным 6 часов и автоматически «дропает» старые сообщения. Без этого вы будете платить за повторную обработку одного и того же контекста.
Настраивается в openclaw.json в секции agents.defaults.compaction.
Hooks
Hooks — кастомные скрипты на TypeScript, которые срабатывают на определённые события. Лежат в workspace/hooks/ и в ~/.openclaw/hooks/. У каждого хука есть свой HOOK.md с описанием.
Hooks позволяют агенту реагировать на события автоматически:
- Пришло сообщение — сработал хук
- Запустилась сессия — сработал хук
- Агент что-то записал в память — сработал хук
Без hooks агент просто отвечает на сообщения. С hooks — обрабатывает входящие данные, фильтрует контекст, дополняет ответы.
OpenClaw сканирует обе папки при запуске и подключает все найденные хуки автоматически.
Чем больше вы общаетесь со своим OpenClaw, тем больше он понимает вас, а вы — его.
✍️ Бонус от меня (Kirill Kazakov) — не часть оригинальной статьи
Промпт для настройки SOUL.md через AI агента:
Помоги мне написать SOUL.md для моего OpenClaw агента. Я хочу агента, который: — общается на [язык], кратко и по делу — имеет мнение и не боится его высказывать — знает мои проекты: [перечисли] — работает в фоне и пишет первым, если что-то важное — не использует корпоративные фразы и не льстит Напиши SOUL.md в стиле манифеста, а не инструкции. Агент должен знать кто он, а не только что делать.
Дисклеймер / Disclaimer: material is published for informational and research purposes. Полный отказ от ответственности / Full disclaimer.