OpenClaw: полное руководство по настройке под себя
Установить OpenClaw — это 20% работы. Остальные 80% — сделать агента по-настоящему полезным. В этой статье разберём, как устроено рабочее пространство, что писать в каждом файле, как работает память, автоматизация и мульти-агентные конфигурации.Рабочее пространство (Workspace)
Рабочее пространство — это папка~/.openclaw/workspace/, в которой живёт «мозг» вашего агента. Каждый раз при старте сессии агент читает файлы из этой папки, чтобы понять, кто он, кто вы и как себя вести.
Структура выглядит так:
Важно: держите только одно активное рабочее пространство. Несколько папок могут вызывать конфликты. Команда openclaw doctor предупредит, если обнаружит лишние.
AGENTS.md — операционные инструкции
Это главный файл. Думайте о нём как о «стандартной операционной процедуре» для агента. Здесь вы описываете:- Что агент должен делать при старте каждой сессии
- Приоритеты и правила поведения
- Как работать с памятью
SOUL.md — личность агента
SOUL.md определяет, как агент общается: тон, границы, ценности, стиль ответов. Этот файл загружается каждую сессию. Пример:Советы по SOUL.md
- Оптимальный размер — 50–150 строк. Больше — агент начинает путаться
- Конкретика лучше абстракций: «отвечай в 1–3 предложениях» работает лучше, чем «будь кратким»
- Не ставьте противоречащие правила («будь кратким» + «всегда объясняй подробно»)
- Примеры ответов — мощнейший инструмент. Покажите, какой стиль вы хотите
- Итерируйте! Первая версия не будет идеальной. Обновляйте после недели использования
USER.md — контекст о вас
USER.md — это «досье» о вас для агента. Загружается каждую сессию. Здесь агент узнаёт, кому он помогает. Пример:IDENTITY.md — «визитка» агента
Короткий файл с именем, ролью и emoji агента. Создаётся при первичной настройке (bootstrap). Используется для отображения в Dashboard и мессенджерах.TOOLS.md — заметки об инструментах
TOOLS.md не контролирует, какие инструменты доступны агенту — это только текстовые заметки. Здесь вы описываете ваши локальные особенности: какие CLI-утилиты установлены, как обращаться к конкретным сервисам, какие ограничения есть.Система памяти
Память — это то, что отличает агента, который «знает вас», от агента, который каждый раз начинает с нуля.Ежедневные логи (memory/)
В конце каждой сессии (при команде/new) агент записывает сводку в файл memory/YYYY-MM-DD.md — что обсуждали, какие решения приняты, что важного произошло. Это происходит автоматически через hook session-memory.
При старте новой сессии агент читает логи за сегодня и вчера — чтобы помнить недавний контекст.
MEMORY.md — долгосрочная память
В отличие от ежедневных логов, MEMORY.md — это вручную курируемый файл. Сюда попадают устойчивые факты: предпочтения, завершённые проекты, важные контакты, выученные уроки. Ключевое правило: регулярно ревьюйте MEMORY.md. Устаревшая память хуже, чем отсутствие памяти. Если агент думает, что вы всё ещё работаете над проектом, который закрыли в январе — он будет постоянно к нему возвращаться. Настройте автоматическое напоминание:Как работает поиск по памяти
OpenClaw использует гибридный поиск: 70% семантический (по смыслу) + 30% по ключевым словам. Это значит, что агент найдёт релевантную информацию, даже если вы не помните точную формулировку.HEARTBEAT.md — проактивный режим
Heartbeat — это периодическая проверка, которую агент выполняет по расписанию (по умолчанию каждые 30 минут). Агент читаетHEARTBEAT.md и решает, нужно ли что-то делать. Если нет — отвечает HEARTBEAT_OK, и сообщение не отправляется.
Пример HEARTBEAT.md:
Советы по Heartbeat
- Держите
HEARTBEAT.mdкоротким — каждый запуск тратит токены - Если файл пустой или содержит только заголовки — heartbeat пропускается автоматически
- Начните с отключённого режима (
"every": "0m"), включите после отладки - Для экономии токенов используйте
lightContext: true— тогда при heartbeat загружается толькоHEARTBEAT.md, без остальных файлов - Heartbeat не заменяет cron: heartbeat — это «проверь и реши, нужно ли действовать», cron — это «выполни конкретную задачу в конкретное время»
Cron-задачи
Cron позволяет запускать агента по расписанию для конкретных задач. Три формата расписания:at— для привязки ко времени дня:{ "at": "08:00" }every— для интервалов:{ "every": "1h" }cron— стандартный cron-синтаксис:{ "cron": "0 9 * * 1-5" }
Совет: формулируйте промпт конкретно. «Проверь дела» не работает. «Получи события из Google Calendar API, отфильтруй внешние встречи, отправь сводку» — работает.
Hooks — реакции на события
Hooks — это скрипты, которые запускаются автоматически при определённых событиях. В отличие от cron (время) и webhook (внешний триггер), hooks реагируют на внутренние события OpenClaw. Основные встроенные hooks:- session-memory — сохраняет контекст сессии в
memory/при команде/new. Это основа системы памяти - boot-md — при старте Gateway выполняет инструкции из
BOOT.md - bootstrap-extra-files — подгружает дополнительные файлы при инициализации агента
- command-logger — логирует все команды в файл
~/.openclaw/hooks/) → bundled.
Скиллы: организация и приоритеты
Скиллы загружаются по трёхуровневой иерархии:- Workspace-скиллы (
<workspace>/skills/) — высший приоритет - Managed-скиллы (
~/.openclaw/skills/) — общие для всех агентов - Bundled-скиллы — ~50 штук, поставляются с OpenClaw
Создание своего скилла
Создайте папку в<workspace>/skills/my-skill/ с файлом SKILL.md:
Мульти-агентная конфигурация
Один Gateway может обслуживать несколько независимых агентов одновременно. Каждый агент получает:- Собственное рабочее пространство (SOUL.md, AGENTS.md и т.д.)
- Изолированное хранилище сессий
- Отдельные профили авторизации
- Собственный набор скиллов
Зачем это нужно
- Разделение по задачам: быстрый агент на Sonnet для ежедневных дел через WhatsApp + мощный агент на Opus для глубокой работы через Telegram
- Разделение по людям: несколько пользователей на одном сервере с полной изоляцией
- Разные уровни доступа: персональный агент с доступом к файлам vs публичный бот в Discord без доступа к exec
Управление агентами
Суб-агенты
Суб-агенты — это фоновые процессы, которые основной агент запускает для параллельного выполнения задач. Они работают в собственной сессии, делают свою работу и возвращают результат.Когда это полезно
- Параллельный ресерч: основной агент отправляет 3 суб-агента искать информацию по разным темам одновременно
- Длинные задачи: суб-агент генерирует отчёт, пока вы продолжаете общаться с основным
- Экономия: основной агент на дорогой модели, суб-агенты — на дешёвой или локальной
Как запустить
Через команду в чате:sessions_spawn — для оркестратора, который сам решает, когда запускать воркеров.
Ограничения
- Глубина вложенности регулируется:
maxSpawnDepth: 2(суб-агент может запустить суб-суб-агента, но не глубже) - Каждый суб-агент — это отдельная сессия с отдельным потреблением токенов
- Суб-агент получает из workspace только
AGENTS.mdиTOOLS.md— не полный контекст
Lobster — встроенный workflow engine
Lobster — это движок для детерминированных пайплайнов внутри OpenClaw. Если суб-агенты — это «параллельные работники», то Lobster — это «конвейер с чётким порядком шагов». Пример: сортировка входящей почты:Полезные команды
| Команда | Что делает |
|---|---|
/new или /reset | Сбросить сессию (начать с чистого листа) |
/compact | Сжать контекст для экономии токенов |
openclaw status | Статус системы |
openclaw status --all | Полная диагностика |
openclaw doctor | Проверка проблем |
openclaw dashboard | Открыть веб-интерфейс |
openclaw cron list | Показать cron-задачи |
openclaw hooks list | Показать хуки |
openclaw skills list | Показать установленные скиллы |
Чеклист первой недели
Дни 1–2: просто общайтесь. Попросите суммаризировать статью. Спросите про погоду. Задайте вопрос, который давно хотели обсудить. Цель — привыкнуть к формату, а не к продуктивности. Дни 3–4: настройте файлы. Заполните SOUL.md, USER.md, AGENTS.md. Начните с шаблонов — OpenClaw создаёт их автоматически приopenclaw setup. Подправьте под себя.
Дни 5–6: добавьте скиллы и автоматизацию. Установите GOG (Google Workspace), настройте утренний брифинг через cron, включите session-memory hook.
День 7: добавьте в группу. Пригласите агента в WhatsApp-группу с друзьями или коллегами (не забудьте включить requireMention: true). Мультиплеерный формат — это отдельный опыт.
После недели корректировок ваш агент будет совершенно не похож на чей-то ещё. В этом и смысл.
Продолжение
Кодинг
Изучи как эффективно вайбкодить
Продуктивность
Узнай как управлять своими задачам.
Контент
Узнай как делать контент в Telegram