17 уроков, которые я хотел бы знать до того, как чуть не бросил OpenClaw

Практические советы после двух недель проб и ошибок. Каждый пункт — реальные грабли, на которые наступили десятки людей до вас.

Урок 0. Правильный настрой

Прежде чем начинать — три вещи, которые стоит принять заранее.

OpenClaw — это как новый джун. Будет ошибаться. Будет делать не то, что вы имели в виду. Ему нужно время на рампинг, и вам нужно время на понимание, как он думает. Не ждите магии из коробки.

Доверяй, но проверяй. Всегда читайте, что предлагает агент — особенно rm, chmod, правку конфигов, рестарты сервисов. Независимо от модели. Один пользователь обнаружил, что агент «случайно» удалил проект, над которым тот работал неделю.

Демо — это не реальность. Люди, которые пишут «мой агент собрал приложение за ночь», потратили недели на тюнинг workspace, скиллов и правил. Разрыв между демо и реальным использованием существует. Он сокращается, но пока ощутим.

Урок 1. Задайте явную рабочую директорию

Первое, что нужно сделать после установки — убедиться, что в конфиге прописана рабочая директория .openclaw/workspace и агент не разбрасывает файлы по всей системе.

json{
  "workspace": {
    "path": "~/.openclaw/workspace"
  }
}

Один из Reddit-постов с лучшими практиками формулирует это жёстко: «Keep a single working directory. If something fails, you can delete the environment instead of panicking».​

Урок 2. Запустите openclaw doctor --fix сразу после установки

Эта команда проверяет конфигурацию, права на файлы, наличие зависимостей и автоматически чинит типичные проблемы.

bashopenclaw doctor --fix

Когда ещё запускать:​

• После каждого обновления OpenClaw — без исключений.
• Когда появляются ошибки валидации конфига.
• Когда hot reload перестаёт работать.
• Когда каналы (Telegram, Slack) не подключаются.

Security-специалист Simon Roses рекомендует: «openclaw doctor --fix после обновлений, openclaw status --deep для утренних проверок, openclaw logs --follow при live-дебаге».​

Урок 3. Заполните базовые workspace-документы

Три файла, без которых агент — слепой котёнок:

• USER.md — кто вы, чем занимаетесь, как обращаться, ваш часовой пояс, предпочтения по языку и формату.
• AGENTS.md — роль агента, границы ответственности, что можно делать, что нельзя, тон общения.
• HEARTBEAT.md — что проверять при каждом heartbeat, когда будить вас, когда молчать.

Из поста «What Actually Works After Running It Daily»: «Если информация не записана в файл — она исчезнет. Session memory теряется при compaction. Это самая частая ошибка новичков».​

Урок 4. Не дебажьте OpenClaw через сам OpenClaw

Когда агент сломался — не пытайтесь чинить его через него же.

Почему:

• Агент в сломанном состоянии даёт плохие советы.
• Попытки «починить себя» усугубляют context bloat.
• Вы сжигаете токены на бесполезный диалог.

Что использовать вместо:

• Claude Code в терминале — посмотреть конфиги, логи, файлы.
• VS Code — редактировать workspace-файлы и openclaw.json.
• CLI-инструменты: openclaw doctor --fix, openclaw logs --follow, openclaw gateway --verbose.
• /debug в чате — для runtime-оверрайдов без правки конфига на диске.​

Урок 5. Начните с одного сценария end-to-end

Не пытайтесь настроить почту + календарь + Telegram + веб-скрапинг + cron одновременно. Каждая интеграция — отдельная точка отказа.

Пользователь с 30-дневным опытом без навыков кодинга пишет: «Если бы я начинал заново, я бы запустил OpenClaw с нулём скиллов, нулём API, нулём автоматизации. Сначала чистое, предсказуемое поведение. Потом добавлять мощность».​

Лучший первый сценарий — утренний брифинг:​

1. Один cron в 8:00.
2. Один SKILL.md с описанием формата.
3. Одна дешёвая модель (Haiku).
4. Добейтесь идеальной работы — и только потом добавляйте следующий воркфлоу.

Урок 6. Явно говорите агенту сохранять важные решения

По умолчанию агент не записывает ничего в persistence memory. Вы можете два дня обсуждать стратегию, а после compaction — всё испарится.​

Правильный паттерн из «Best Practices: What Actually Works»:​

• MEMORY.md — долгосрочный контекст (решения, предпочтения, важные факты).
• memory/YYYY-MM-DD.md — дневные логи.
• ACTIVE-TASK.md — рабочая память для многошаговых задач.
• Агент должен чекпоинтить прогресс по ходу работы, а не только в конце.​

Добавьте в AGENTS.md триггер: фраза «хочу начать новый чат» = немедленно сохранить всё важное в файлы.

Урок 7. Используйте state-файлы для долгосрочного состояния

State-файлы — это workspace/state/ — отдельная папка для хранения прогресса, флагов и промежуточных данных.​

В отличие от чат-истории, state-файлы:

• Не зависят от compaction.
• Не теряются при /new или /reset.
• Доступны любому агенту и любой cron-задаче.

Примеры: state/competitors_prices.json, state/email_queue.jsonl, state/weekly_report_progress.md.

Урок 8. Регулярно обновляйте USER.md и AGENTS.md

Workspace-документы инжектируются в каждый запрос. Если они устарели — агент работает по устаревшим инструкциям и «переучивается» каждый раз заново.​

Рекомендация: раз в неделю пробегитесь по USER.md и AGENTS.md. Удалите неактуальное, добавьте новое. Каждая строка должна «зарабатывать» своё место — иначе она просто ест токены.

Урок 9. 80% расходов на токены — это heartbeats и рутина

Перевести heartbeats и cron на дешёвые модели — самое эффективное, что можно сделать для бюджета.

Конкретные цифры из комьюнити: пользователи снижали расход с 20–40 тыс. токенов до 1,5 тыс. просто за счёт маршрутизации. Один инженер срезал счёт с $1000/мес до $200/мес.​

Паттерн «heartbeat over cron for checks»: heartbeats для проверок (почта, календарь, статусы), cron — для точных задач в конкретное время. Heartbeats батчат проверки и снижают количество API-вызовов.

​

Урок 10. Попросите агента помочь построить token-модель промптов

Ироничный, но рабочий совет: используйте OpenClaw (или Claude Code), чтобы проанализировать ваши workspace-файлы и промпты на предмет избыточности. Часто оказывается, что:​

• AGENTS.md содержит 5 повторений одного и того же правила разными словами.
• MEMORY.md хранит устаревшие решения двухнедельной давности.
• Скиллы дублируют инструкции из AGENTS.md.

Попросите: «Проанализируй мои workspace-файлы и предложи, как сократить их на 30% без потери смысла».

Урок 11. Для локальных моделей: настройте embedding-модель

Без embedding-модели (например, nomic-embed-text) весь workspace улетает в каждый запрос как сырой текст. С embedding’ами OpenClaw ищет только релевантные куски — экономия колоссальная.​​

Это особенно критично для моделей с маленьким контекстом (8K–32K), где каждый токен на счету.

Урок 12. LM Studio: фиксируйте настройки правильно

Если используете LM Studio для локальных моделей — три вещи, которые нужно знать:​​

• Context length, KV cache quant, batch size — сохранять в My Models, а не в runtime settings. Runtime settings сбрасываются при перезагрузке.
• Flash Attention — ставить On, не Auto. Auto иногда выбирает неоптимальный режим.
• Если модель крашится через 5–10 минут — скорее всего, контекстное окно слишком большое для вашей VRAM. Уменьшите num_ctx до 2048 или 4096.​

Урок 13. Отложенные задачи — в очередь, а не в голову

«Сделай это завтра», «напомни через три дня», «когда освободишься, разошли отчёты» — всё это должно жить в очереди задач, а не в чат-истории.

Три варианта по уровню сложности:

• Текстовый файл (state/tasks_queue.jsonl) — максимально просто, ноль зависимостей.
• SQLite (state/tasks.db) — если задач много и нужны фильтры/сортировка.
• Notion — если хотите видеть очередь в красивом интерфейсе и управлять задачами руками.

Плюс cron, который каждые 10–15 минут проверяет очередь и запускает «созревшие» задачи.​

Урок 14. Для разных cron задавайте разные модели

Каждая cron-задача может иметь свой --model:

bash# Утренний брифинг — дёшево
openclaw cron add --name "Brief" --cron "0 8 * * *" --model "haiku" --message "..."

# Еженедельный ресёрч — качественно
openclaw cron add --name "Research" --cron "0 10 * * 1" --model "sonnet" --message "..."

# Heartbeat — бесплатно
# (настраивается в openclaw.json → agents.defaults.heartbeat.model)

Пользователь с 30-дневным опытом пишет: «Setup with Opus, optimize later. Но когда оптимизируете — переведите 90% задач на дешёвые модели. Opus оставьте только для того, что реально требует мощного рассуждения».​

Урок 15. Heartbeat на локальной модели — интервал минимум 2 часа

Heartbeat на слабой модели с коротким интервалом (5–10 минут) — путь к деградации. Агент начинает «забывать» контекст между пингами, генерирует бессмысленные ответы и сжигает ресурсы.

Рекомендация: для локальных моделей heartbeat раз в 2 часа. Для облачных дешёвых (Haiku, Flash) — раз в 30–60 минут.​

Урок 16. Home Assistant: ограничьте список entities

Если подключаете умный дом — не давайте агенту весь дом. Выделите 10–15 конкретных устройств, которыми он может управлять. Остальное — невидимо.

Почему:

• Длинный список entities раздувает контекст.
• Агент начинает «экспериментировать» с устройствами, о которых вы забыли.
• Риски безопасности: замки, камеры, отопление — лучше не давать без явного контроля.

Лучший паттерн — прокси-слой (n8n или кастомный API), который выставляет только выбранные сущности и действия.

Урок 17. Следите за context bloat — используйте compaction summaries

По мере роста истории контекст раздувается. Это приводит к замедлению ответов, росту расходов на токены и деградации качества.

Практический чеклист:

• Каждые 15–20 минут проверяйте /status — если загрузка выше 60%, запускайте /compact.​
• Разбивайте работу на логические блоки: закончили фазу → /compact или /new.​
• Знайте «дорогие» операции: чтение большого файла = +10K токенов, verbose test output = ещё больше. Перед тяжёлой операцией — превентивный /compact.​

Пользователь с ежедневным опытом формулирует лучше всех: «Reset frequently. If things feel slow, expensive, or odd — reset the session. You’re not preserving consciousness; you’re managing a tool».​

Бонус: 10 правил из Reddit, которые стоит распечатать

Один из самых заплюсованных постов по OpenClaw — «Best Practices (learned the hard way)» — содержит 10 правил, которые стоит повесить рядом с монитором:​

1. Изолируйте. Не запускайте на основной машине — VPS, VM или отдельный пользователь.
2. Начните просто. Дешёвая модель, ноль скиллов, ноль API. Сначала предсказуемое поведение — потом мощность.
3. Права — максимально узкие. Одна папка на чтение, одна на запись. Нет доступа к домашнему каталогу и dotfiles.
4. Skills — это исполняемый код. Читайте исходники перед установкой. Ставьте по одному.
5. OAuth лучше API-ключей. Если ключ утечёт и это сломает вашу неделю — OpenClaw его не должен иметь.
6. Мониторьте контекст и память. Раздутые сессии замедляют, удорожают и делают поведение хаотичным.
7. Human approval для необратимых действий. Запись файлов, отправка сообщений, команды, API-вызовы — только с подтверждением.
8. Считайте, что prompt injection произойдёт. Если агент читает веб, почту или чат-логи — кто-то попытается им манипулировать.
9. Разделяйте песочницу и продакшен. Один агент для экспериментов, другой для реальных задач. Никогда не тестируйте новые скиллы на агенте с доступом к реальным данным.
10. Резетьте часто. Если что-то замедлилось, подорожало или стало странным — /reset. Вы управляете инструментом, а не сохраняете сознание.

Финальное правило автора поста: «OpenClaw works best when it feels slightly constrained. If it feels magical, you’ve probably given it too much power».​

OpenClaw — не магия. Это инструмент. Мощный, гибкий, open-source — но требующий настройки, дисциплины и здравого смысла. Те, кто потратил время на правильный фундамент, получают агента, который реально экономит часы каждый день. Остальные — бросают через неделю.

Не бросайте. Настройте.