База знаний

SOUL.md — как задать характер ИИ-агенту в OpenClaw

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 — не священный текст, а рабочий документ, который стоит обновлять по мере уточнения ожиданий
  • Версионируйте файл, чтобы откатить неудачные изменения

Ссылки

По теме

Если вы строите собственного ИИ-агента и хотите, чтобы он звучал как вы, а не как шаблон — это хорошая отправная точка для разговора.