На карте
SOUL.md задаёт голос, характер и манеру общения ИИ-агента в OpenClaw. Через него можно управлять краткостью, прямотой, юмором, позицией и поведенческими границами, сохраняя рабочие процедуры агента в отдельном файле.
Материал рассчитан на владельцев и настройщиков OpenClaw, которые уже создали рабочее пространство агента (workspace) и хотят сделать его ответы узнаваемыми и последовательными.
Содержание
- Общая картина: где работает SOUL.md
- Какие правила стоит добавить
- Что хранить в AGENTS.md
- Рабочий шаблон SOUL.md
- Как проверить изменения
- Чеклист быстрой проверки
- Если характер не проявляется
Общая картина: где работает SOUL.md
OpenClaw подключает SOUL.md к контексту обычных сессий агента. Записанные правила влияют на формулировки ответов: если агент звучит пресно, уклончиво или чрезмерно официально, документация OpenClaw предлагает начать с этого файла.
Файл должен находиться в настроенном рабочем пространстве агента. Если сессия запускается из другой папки или управляемого рабочего дерева (managed worktree), OpenClaw оставляет эту папку рабочей папкой выполнения, но не загружает из неё SOUL.md. Для настроек личности используется файл из настроенного workspace.
В нативном сценарии Codex OpenClaw не дублирует стабильные workspace-файлы в каждом пользовательском сообщении. В управляемом stdio-сценарии приложения, то есть запуске через стандартный поток, SOUL.md добавляется только к инструкциям родительского запуска; нативная история его не содержит. Поэтому настройка характера не переходит автоматически к нативным субагентам. В сессиях субагентов подключается только AGENTS.md.
Размер bootstrap-файлов, то есть файлов начальной загрузки контекста, ограничен. В документации, проверенной 10 сентября 2026 года, указаны значения по умолчанию: до 20 000 символов на файл и до 60 000 символов суммарно. Если лимит превышен, OpenClaw передаёт модели сокращённую копию с уведомлением об обрезке, а исходный файл не изменяет.
SOUL.md в настроенном workspace ещё не означает, что его содержимое полностью попадёт в каждый тип запуска. На результат влияют среда, режим системного промпта и лимиты bootstrap-файлов.Какие правила стоит добавить
В SOUL.md полезны инструкции, которые меняют ощущение от разговора:
- желаемый тон: спокойный, дружелюбный, ироничный или строгий;
- допустимая степень категоричности;
- краткость ответа по умолчанию;
- отношение к юмору и разговорной лексике;
- готовность прямо указывать на слабые решения;
- поведенческие границы и поправки для публичных каналов;
- несколько коротких примеров удачных и неудачных формулировок.
Формулируйте правила через наблюдаемое поведение. Указание «отвечай одним абзацем, если вопрос не требует разбора» легче проверить, чем просьбу «будь лаконичным и полезным».
| Размытое правило | Проверяемая формулировка |
| Будь профессиональным | Отвечай спокойно и без канцелярита; технические ограничения называй прямо |
| Оказывай всестороннюю помощь | Сначала дай решение, затем добавь детали, которые нужны для его применения |
| Будь дружелюбным | Не начинай с дежурной похвалы вопросу; переходи сразу к ответу |
| Проявляй характер | Если предложенный подход слабый, скажи об этом и предложи более надёжный вариант |
Не превращайте файл в биографию персонажа, журнал изменений или длинный перечень абстрактных качеств. Политики безопасности, порядок работы с инструментами и процедуры выполнения задач лучше вынести в операционные инструкции.
Что хранить в AGENTS.md
У двух файлов разные роли. Официальная документация OpenClaw разделяет голос и рабочие правила:
| Файл | Что в нём хранить | Пример |
SOUL.md | Голос, позицию, краткость, юмор, прямоту и стиль общения | «Сначала отвечай по существу. Детали добавляй по необходимости» |
AGENTS.md | Рабочие правила, инструменты, последовательности действий и ограничения процессов | «Перед изменением конфигурации прочитай текущее состояние и сохрани существующие настройки» |
Поведенческая выразительность не отменяет точность. Если агент отвечает в общем чате, клиентском канале или другом публичном пространстве, задайте подходящую степень прямоты. Резкий стиль, приемлемый в личной беседе, может мешать работе команды.
Рабочий шаблон SOUL.md
Начните с пяти–семи правил и расширяйте файл только после проверки реальных диалогов.
# SOUL.md
## Голос
- Пиши ясно и конкретно.
- Сразу переходи к ответу без дежурных вступлений.
- Если достаточно одного предложения, остановись на одном предложении.
- Высказывай обоснованную позицию вместо автоматического перечисления всех вариантов.
- Указывай на слабые идеи прямо, но без грубости.
- Используй юмор только там, где он возникает естественно.
- Для публичных и клиентских каналов выбирай более сдержанный тон.
## Примеры
Хорошо: «Этот вариант усложняет поддержку. Проще оставить один источник конфигурации».
Плохо: «Отличный вопрос! Здесь всё зависит от множества факторов, которые следует всесторонне рассмотреть».Шаблон задаёт исходную точку. Правила стоит адаптировать под задачи агента, аудиторию и каналы, в которых он отвечает.
Как проверить изменения
Проверяйте несколько типовых запросов, а не один специально подобранный пример. Проверка ниже описывает методику для вашей среды по документации OpenClaw; фактический запуск конкретной конфигурации в рамках этого материала не выполнялся.
| Проверка | Тестовый запрос | Наблюдаемый результат |
| Краткость | Простой вопрос с однозначным ответом | Агент отвечает коротко и не добавляет ненужный обзор |
| Позиция | Просьба выбрать один из двух подходов | Агент делает выбор и объясняет главный критерий |
| Прямота | Заведомо сложное или хрупкое решение | Агент называет риск и предлагает более простой вариант |
| Глубина | Технический вопрос с несколькими условиями | Агент раскрывает детали, несмотря на правило о краткости |
| Контекст канала | Один запрос в личном и публичном пространстве | В публичном канале тон заметно сдержаннее |
Практический цикл настройки:
- Зафиксируйте текущую версию
SOUL.md. - Измените одно или два правила.
- Повторите одинаковый набор типовых запросов.
- Сравните длину, тон, прямоту и полезность ответов.
- Оставьте только правила с заметным поведенческим эффектом.
- Сохраните удачную версию в системе контроля версий.
Для проверки фактически подключённого контекста OpenClaw предусмотрены команды:
| Команда | Что показывает |
/context list | Краткий список элементов, участвующих в контексте |
/context detail | Подробный вклад файлов, исходный и переданный размер, сокращение и накладные расходы инструментов |
Чеклист быстрой проверки
SOUL.md находится в настроенном workspace нужного агента.AGENTS.md./context detail подтверждено, что файл присутствует в контексте.Если характер не проявляется
Если правила присутствуют в контексте, но почти не влияют на ответы, сократите файл и замените общие пожелания конкретными формулировками с примерами. Меняйте небольшое число правил за один проход: так проще определить, какое из них дало результат.
Если /context detail не показывает SOUL.md, сначала проверьте настроенное рабочее пространство и среду запуска. Настройку формулировок имеет смысл менять после того, как подключение файла подтверждено.
Правила краткости не должны мешать давать необходимые технические подробности. Тон также нужно адаптировать к каналу: формулировка, подходящая для личного диалога, может быть слишком резкой для общего или клиентского пространства.
Официальные источники
Сведения о поведении OpenClaw и лимитах сверены 10 сентября 2026 года по официальной документации:
- Руководство OpenClaw по SOUL.md
- Сборка системного промпта и подключение workspace-файлов
- Официальный шаблон AGENTS.md
- OpenClaw — официальный сайт
Следующий шаг
OpenClaw в 2026: персональный ИИ-агент, который живёт на вашем железе и работает из мессенджеров
Если вы настраиваете собственного агента и хотите проверить, что правила характера работают в нужном контексте, этот набор тестов поможет отделить рабочие формулировки от тех, что только занимают место.
Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov
