SOUL.md — файл личности агента в OpenClaw. Разбираем, что в него писать, чего избегать и как сделать агента живым, а не корпоративно-пресным.
Что такое SOUL.md
SOUL.md — это файл в структуре OpenClaw, который определяет голос и характер вашего ИИ-агента. Платформа автоматически подгружает его в каждую сессию, так что всё, что вы туда напишете, реально влияет на поведение агента.
Если ваш агент звучит пресно, уклончиво или как корпоративный чат-бот — скорее всего, проблема именно здесь.
Что писать в SOUL.md
В этот файл идёт всё, что меняет ощущение от общения с агентом:
- Тон — дружелюбный, сдержанный, ироничный
- Мнения — позиция по ключевым вопросам предметной области
- Краткость — насколько развёрнуто агент отвечает по умолчанию
- Юмор — уместен ли, и в каком формате
- Границы — что агент не обсуждает или отклоняет
- Уровень прямоты — насколько агент готов называть вещи своими именами
Чего избегать
SOUL.md — не место для:
- Биографии агента на два экрана
- Списка изменений и чейнджлогов
- Политик безопасности
- Расплывчатых «вайбов» без конкретного поведенческого эффекта
Главное правило: короткое лучше длинного, точное лучше размытого.
Хорошие правила vs. плохие
Сравните два подхода:
Работает:
- Имей точку зрения
- Пропускай воду
- Шути, когда это уместно
- Сразу говори, если идея слабая
- Будь кратким, если глубина реально не нужна
Не работает:
- Сохраняй профессионализм в любой ситуации
- Обеспечивай комплексную и вдумчивую помощь
- Создавай позитивный и поддерживающий опыт
Второй список — рецепт каши. Агент формально выполняет инструкцию, но звучит как все остальные.
Почему это работает
Подход совпадает с рекомендациями OpenAI по промпт-инжинирингу: тон, цели и поведенческие примеры нужно размещать в слое инструкций с высоким приоритетом, а не прятать в пользовательских сообщениях.
В OpenClaw SOUL.md — именно такой слой. Платформа инжектирует его содержимое в системный промпт, поэтому написанное в этом файле имеет прямое влияние на каждый ответ агента.
Разграничение с AGENTS.md
В OpenClaw есть два ключевых файла:
- AGENTS.md — операционные правила: что агент делает, с какими инструментами работает, какие процессы выполняет
- SOUL.md — голос и стиль: как агент говорит, какую позицию занимает, какой тон использует
Если агент работает в публичных каналах, чатах с клиентами или командных пространствах — убедитесь, что тон из SOUL.md подходит контексту. Острота — хорошо. Раздражение — нет.
Практические рекомендации
- Начните с 5–7 коротких правил, описывающих желаемое поведение
- Формулируйте как действия, а не как абстрактные качества
- Тестируйте: отправьте агенту типичный запрос и оцените, изменился ли тон
- Итерируйте: SOUL.md — не священный текст, а рабочий документ, который стоит обновлять по мере уточнения ожиданий
- Версионируйте файл, чтобы откатить неудачные изменения
Ссылки
По теме
Если вы строите собственного ИИ-агента и хотите, чтобы он звучал как вы, а не как шаблон — это хорошая отправная точка для разговора.