Уроки по настройке рабочего пространства OpenClaw: опыт двух месяцев использования

Пользователь OpenClaw поделился подробными выводами после двух месяцев использования ИИ-агента для программирования, подчеркнув, что конфигурация рабочего пространства важнее самого инструмента. Разработчик обнаружил, что хорошо настроенное рабочее пространство улучшает опыт в 5-10 раз по сравнению со стандартной настройкой.

Конфигурация SOUL.md

Общие инструкции вроде "будь полезным и профессиональным" имеют минимальный эффект. Эффективные файлы SOUL.md должны:

• Включать конкретные модели поведения, такие как "сначала давай ответ, потом контекст" или "если не знаешь, так и скажи, не выдумывай"
• Ограничиваться 50-150 строками максимум, так как каждая строка расходует токены контекстного окна
• Фокусироваться на крайних случаях, а не на обычных сценариях: что должен делать агент, когда он чего-то не знает, когда запросы выходят за рамки или когда приоритеты конфликтуют
• Тестировать каждую строку вопросом: если её удалить, изменится ли поведение агента? Если нет — удаляйте

AGENTS.md как стандартная рабочая процедура

Этот файл должен отвечать на вопрос "как ты работаешь", а не "кто ты" (это роль SOUL.md). Ключевые инсайты:

• Самое ценное добавленное правило: "перед любой нетривиальной задачей сначала запускай memory_search", чтобы предотвратить догадки
• Когда агент допускает ошибки, добавляйте правила для предотвращения повторения, причём отрицательные инструкции ("никогда не делай X без проверки Y") часто работают лучше положительных
• Правила в bootstrap-файлах носят рекомендательный характер — модель следует им потому, что её попросили, а не потому, что они принудительны
• Для правил, которые действительно нельзя нарушать, используйте политику инструментов и конфигурацию песочницы вместо того, чтобы полагаться на строго сформулированный markdown

Управление MEMORY.md

Этот файл загружается каждый сеанс, поэтому он должен содержать только информацию, требующую постоянного сохранения:

• Включайте ключевые решения, предпочтения пользователя, операционные уроки и правила, извлечённые из ошибок
• Ежедневная информация помещается в файлы memory/YYYY-MM-DD.md, которые агент ищет при необходимости
• Жёсткие ограничения: 20 тыс. символов на файл, 150 тыс. суммарно по всем bootstrap-файлам — превышение вызывает молчаливое усечение
• Инструкции, введённые в чате, НЕ сохраняются после сжатия контекста
• Подключите рабочее пространство к git, чтобы восстановить случайно перезаписанные файлы MEMORY из истории коммитов

USER.md и оптимизация навыков

Файл USER.md недооценён — включение информации о фоне, предпочтениях, часовом поясе и рабочем контексте снижает повторения и экономит токены. Что касается навыков:

• Установка 30 навыков не вставляет 30 полных файлов навыков в каждый промпт, но сам список навыков потребляет контекст
• Сокращение с 15+ навыков до 5 заметно улучшило качество вывода
• Тест: если бы навык исчез завтра, вы бы заметили? Если нет — удалите его

Распространённые проблемы при плохой настройке

Когда настройка персонажа не проработана, эти проблемы быстро проявляются:

• Агент постоянно отклоняется, требуя постоянной коррекции в бесконечном цикле
• Токены тратятся на неэффективные действия, например, открытие браузера, когда сработал бы скрипт
• Слишком много загруженных навыков, раздувающих контекст и мешающих нормальной работе
• Несогласованный вывод для одной и той же задачи в разных сеансах

Разработчик, работающий в e-commerce, создал персонажей для поиска товаров и операций Shopify после того, как обнаружил, что большинство доступных персонажей неадекватны. Он отметил, что хотя в каждой отрасли есть рабочие процессы, которые можно упаковать в персонажей, хорошие ресурсы разбросаны по платным платформам, GitHub, случайным блогам и старым постам, причём многие "персонажи" представляют собой просто отдельные файлы SOUL, которые нельзя использовать из коробки.