Как настроить SOUL.md и AGENTS.md в OpenClaw — полный гайд

Обновлено 
Как настроить SOUL.md и AGENTS.md в OpenClaw — полный гайд

OpenClaw — это мощная платформа для создания персонализированных AI-агентов, но многие разработчики застревают на этапе настройки основных файлов конфигурации. Сегодня разберём детальную настройку SOUL.md и AGENTS.md — двух ключевых файлов, которые превращают обычную языковую модель в интеллектуального помощника с уникальной личностью и чёткими операционными правилами.

Что такое SOUL.md и AGENTS.md и зачем они нужны

Архитектура OpenClaw построена на философском разделении: SOUL.md отвечает за личность агента, а AGENTS.md — за операционные правила. Это не случайное решение, а продуманный подход, который помогает создавать более стабильных и предсказуемых агентов.

SOUL.md — это философское ядро вашего агента. Здесь вы определяете не то, что агент делает, а то, кем он является. Представьте это как корпоративный кодекс ценностей: он не описывает конкретные должностные обязанности, но задаёт принципы принятия решений в любых ситуациях.

Ключевой инсайт из практического опыта: в SOUL.md нужно описывать как агент думает, а не что он может делать. Вместо "Никогда не удаляй файлы" лучше написать: "Предпочитай обратимые операции постоянным: используй корзину вместо прямого удаления и всегда спрашивай перед деструктивными действиями".

AGENTS.md служит операционным руководством. Если SOUL.md описывает характер, то AGENTS.md — рабочие процессы, правила безопасности, конвенции управления памятью и поведение в групповых чатах. Этот файл эволюционирует по мере накопления опыта работы с агентом.

💡 Важно: SOUL.md остаётся стабильным и отражает базовые ценности, в то время как AGENTS.md постоянно обновляется на основе полученного опыта.

Экосистема рабочего пространства OpenClaw

Помимо основных файлов, агент OpenClaw работает в структурированном пространстве с несколькими поддерживающими файлами:

  • USER.md — информация о человеке-операторе: имя, часовой пояс, предпочтения в коммуникации, текущие проекты
  • MEMORY.md — кураторская долгосрочная память, содержит дистиллированную суть важного контекста
  • TOOLS.md — пользовательские конвенции использования инструментов и заметки об окружении
  • HEARTBEAT.md — лёгкий чеклист для периодических проверок каждые 30 минут
  • BOOTSTRAP.md — выполняется только при первой инициализации агента

Особо важно понимать различие между MEMORY.md и ежедневными файлами памяти (memory/YYYY-MM-DD.md). Ежедневные файлы накапливают сырые логи разговоров, а MEMORY.md содержит кураторские высококачественные воспоминания, которые должны сохраняться.

Настройка SOUL.md: философия вместо инструкций

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

Базовая структура SOUL.md

Хорошо структурированный SOUL.md обычно включает:

  • Основные истины и ценности — принципы, управляющие всем последующим поведением
  • Черты личности — юмор, теплота, прямолинейность
  • Стиль коммуникации — как агент выражает мысли
  • Система принятия решений — логика выбора в спорных ситуациях
  • Границы и красные линии — что агент никогда не будет делать

Пример эффективной записи в SOUL.md:

Будь искренне полезным, а не показушно полезным. Пропускай "Отличный вопрос!" и "Буду рад помочь!" — просто помогай. Дела говорят громче дежурных фраз.

Критические границы

Секция границ в SOUL.md заслуживает особого внимания, поскольку определяет, что агент будет категорически отказываться делать. В отличие от процедурных правил AGENTS.md, границы SOUL.md выражаются как ценности:

Приватное остаётся приватным. Точка. У тебя есть доступ к жизни человека — его сообщениям, файлам, календарю, возможно даже к дому. Это интимность. Относись к ней с уважением.

Конфигурация AGENTS.md: операционные правила и процедуры

AGENTS.md содержит конкретные инструкции о том, как агент должен выполнять задачи, взаимодействовать с системами и управлять своей памятью.

Ключевые секции AGENTS.md

Управление памятью: Правила записи важного контекста в файлы вместо полагания на ментальные заметки. Агент должен знать, когда искать в памяти перед действием.

Правила безопасности: Обращение с внешним контентом как с потенциально враждебным, процедуры проверки и валидации.

Поведение в группах: Когда отвечать в групповых чатах, а когда молчать. Различия между приватными сессиями и групповым взаимодействием.

Конвенции рабочих процессов: Планирование перед исполнением, использование под-агентов для сложных задач, эскалация проблем.

Пример правила в AGENTS.md:

Перед началом любого действия:
1. Прочитай MEMORY.md и сегодняшний файл памяти
2. Найди релевантный контекст в истории
3. Если контекста недостаточно — спроси уточнения
4. Только потом действуй

Практические шаги настройки

Шаг 1: Создание базового SOUL.md

Начните с определения 3-5 ключевых ценностей вашего агента. Сформулируйте их как принципы, а не запреты. Добавьте описание личности и стиля коммуникации.

Шаг 2: Настройка AGENTS.md

Определите основные операционные правила: как агент должен управлять памятью, взаимодействовать с инструментами, обрабатывать ошибки.

Шаг 3: Заполнение USER.md

Предоставьте агенту информацию о себе: имя, часовой пояс, предпочтения, текущие проекты. Это поможет агенту принимать контекстно-осведомлённые решения.

Шаг 4: Инициализация через BOOTSTRAP.md

Позвольте агенту пройти процесс начальной инициализации. Не отправляйте существенные вопросы до завершения бутстрапа.

Шаг 5: Итеративное улучшение

Наблюдайте за поведением агента и корректируйте AGENTS.md на основе накопленного опыта. SOUL.md изменяйте реже и осторожнее.

Распространённые ошибки и как их избежать

❌ Ошибка: Смешивание личности и правил в одном файле

✅ Решение: Строго разделяйте ценности (SOUL.md) и процедуры (AGENTS.md)

❌ Ошибка: Слишком детальные и жёсткие правила в SOUL.md

✅ Решение: Используйте принципы, которые агент может применять контекстно

❌ Ошибка: Игнорирование процесса BOOTSTRAP.md

✅ Решение: Дайте агенту завершить инициализацию перед отправкой вопросов

❌ Ошибка: Загрузка MEMORY.md в групповые контексты

✅ Решение: MEMORY.md должен загружаться только в приватных сессиях для безопасности

❌ Ошибка: Переполнение MEMORY.md сырой информацией

✅ Решение: Регулярно кураторствуйте память, оставляя только высокосигнальную информацию

FAQ: Часто задаваемые вопросы

В: Можно ли изменять SOUL.md после создания агента?

О: Да, но делайте это осторожно. Кардинальные изменения личности могут нарушить консистентность поведения. Лучше вносить постепенные корректировки и тестировать их влияние.

В: Как понять, что AGENTS.md нуждается в обновлении?

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

В: Какой оптимальный размер этих файлов?

О: SOUL.md: 300-800 слов, AGENTS.md: 500-1500 слов. Больше — риск превышения контекстного окна, меньше — недостаток направляющей информации.

Чеклист для проверки конфигурации 📋

  • ✅ SOUL.md содержит принципы, а не жёсткие правила
  • ✅ AGENTS.md описывает конкретные операционные процедуры
  • ✅ USER.md заполнен актуальной информацией о пользователе
  • ✅ Границы безопасности чётко определены в обоих файлах
  • ✅ Правила управления памятью настроены в AGENTS.md
  • ✅ Процесс BOOTSTRAP.md завершён успешно
  • ✅ Файлы регулярно обновляются на основе опыта

Грамотная настройка SOUL.md и AGENTS.md — это фундамент эффективного AI-агента. Инвестируйте время в продумывание этих файлов на начальном этапе, и ваш агент будет работать стабильно и предсказуемо в долгосрочной перспективе.

🚀 Хотите углубиться в тему AI-агентов и автоматизации? Присоединяйтесь к обсуждениям в моём Telegram-канале → https://t.me/aaakalsin