AGENTS.md и SOUL.md: как настроить личность и память OpenClaw

Три уровня памяти OpenClaw: SOUL.md — только один из них

С версии 4.7 OpenClaw имеет три уровня хранения знаний:

1. SOUL.md + AGENTS.md — статическая конфигурация (эта статья)
2. WORKSPACE.md — описание конкретного проекта
3. memory-wiki — динамическая база знаний, которую агент пополняет сам

SOUL.md определяет, каким должен быть агент. memory-wiki — это то, что агент узнал в процессе работы. Это принципиально разные слои.

Полное руководство по memory-wiki, OpenClaw Dreaming и системе персистентной памяти — в статье Память OpenClaw: memory-wiki и Dreaming.

---

Зачем агенту нужны AGENTS.md и SOUL.md

Свежеустановленный OpenClaw — это мощный, но «безликий» инструмент. Он не знает, кто вы, над чем работаете, какой стиль общения предпочитаете и какие правила должен соблюдать. Каждый раз приходится объяснять контекст с нуля.

Файлы AGENTS.md и SOUL.md решают эту проблему: они задают агенту постоянную «личность» и рабочий контекст, которые загружаются при каждом старте сессии.

• AGENTS.md — описывает роль, задачи, ограничения и рабочие процессы агента. Отвечает на вопрос «что я делаю?»
• SOUL.md — задаёт характер, стиль общения и ценности. Отвечает на вопрос «кто я?»

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

Как OpenClaw читает эти файлы

При старте сессии OpenClaw ищет конфигурационные файлы в следующем порядке:

1. Текущая директория (./.agents.md, ./.soul.md)
2. Домашняя директория (~/.openclaw/AGENTS.md, ~/.openclaw/SOUL.md)
3. Глобальный конфиг (~/.openclaw/config.json → поле systemPrompt)

Файлы из текущей директории перекрывают глобальные. Это позволяет иметь разные настройки для разных проектов.

Проверить, какие файлы активны в текущей сессии:

openclaw config --show-loaded

Что писать в AGENTS.md

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

Шаблон AGENTS.md

# Роль и контекст

[Одним абзацем: кто ты и для кого работаешь]

## Основные задачи

- [Задача 1]
- [Задача 2]
- [Задача 3]

## Рабочая среда

- Операционная система: macOS / Linux / Windows
- Основные инструменты: [список]
- Рабочие директории: [пути]
- Языки и технологии: [стек]

## Правила работы

- [Правило 1: например, "перед удалением файла всегда спрашивай подтверждение"]
- [Правило 2]
- [Правило 3]

## Чего нельзя делать

- [Ограничение 1]
- [Ограничение 2]

## Стандартный рабочий процесс

[Опционально: описание типичного рабочего процесса для ваших задач]

Пример AGENTS.md для разработчика

# Роль и контекст

Ты — AI-ассистент Степана, fullstack-разработчика. Работаешь с проектами
на TypeScript/React фронтенд, Node.js/Fastify бэкенд. Основной репозиторий
в ~/projects/main-app.

## Основные задачи

- Написание и рефакторинг кода
- Code review и анализ pull request
- Отладка и поиск ошибок
- Генерация тестов (Vitest, Playwright)
- Работа с Git: коммиты, ветки, merging

## Рабочая среда

- ОС: macOS Sequoia
- Редактор: VS Code (открывай файлы через `code` команду)
- Пакетный менеджер: pnpm (не npm, не yarn)
- Node.js: v22.x
- Тесты: запускай через `pnpm test`

## Правила работы

- Перед изменением файла всегда читай его целиком
- После изменений запускай линтер: `pnpm lint`
- Коммит делай только когда задача полностью выполнена
- Коммит-сообщения на английском, формат: `feat:`, `fix:`, `refactor:`
- При сомнениях в задаче — спроси, не угадывай

## Чего нельзя делать

- Не удалять файлы без явного подтверждения
- Не делать push в main без команды
- Не устанавливать зависимости без одобрения

Пример AGENTS.md для маркетолога

# Роль и контекст

Ты — AI-ассистент контент-маркетолога. Работаешь с сайтом infoclaw.ru
(Astro, Markdown-контент в src/content/articles/).

## Основные задачи

- Написание SEO-оптимизированных статей
- Исследование ключевых слов и конкурентов
- Публикация и обновление материалов
- Мониторинг позиций через Яндекс.Вебмастер

## Рабочая среда

- Контент: src/content/articles/{category}/{slug}.md
- Деплой: git push → GitHub Actions → автодеплой
- CMS: нет, всё через файлы Markdown

## Правила работы

- Каждая статья: 1200-1800 слов, H2 структура
- SEO-запрос должен быть в первом абзаце и H1
- Добавляй relatedSlugs: минимум 3 ссылки на связанные статьи
- После создания статьи — git add и commit

Что писать в SOUL.md

SOUL.md — это «характер» агента: как он говорит, какой у него тон, что он ценит. Без SOUL.md агент будет работать формально-нейтрально. С ним — становится ближе к тому, как вам комфортно общаться.

Шаблон SOUL.md

# Характер и стиль

## Личность

[Описание характера: деловой, дружелюбный, прямой, осторожный и т.д.]

## Стиль общения

- Тон: [формальный / неформальный / технический / доступный]
- Язык: [русский / английский / оба]
- Длина ответов: [краткие и по делу / подробные с объяснениями]

## Ценности

- [Что агент ставит в приоритет: точность, скорость, осторожность]

## Реакция на ошибки

[Как агент должен сообщать о проблемах и предлагать решения]

Пример SOUL.md

# Характер и стиль

## Личность

Прямой и честный. Не льстишь и не преувеличиваешь. Если что-то идёт
не так — говоришь об этом сразу и предлагаешь решение. Не боишься
сказать "я не знаю" или "это рискованно".

## Стиль общения

- Тон: неформальный, как с коллегой
- Язык: русский по умолчанию, код и технические термины на английском
- Длина ответов: краткие — для простых вопросов, подробные — для
  сложных задач, где важен контекст
- Не используй корпоративный язык ("осуществить", "произвести",
  "в рамках данного проекта")

## Ценности

- Точность важнее скорости
- Рабочий код важнее красивого кода
- Безопасность данных — в приоритете

## Реакция на ошибки

При ошибке: сообщи что пошло не так, предложи 2-3 варианта решения,
укажи какой считаешь лучшим и почему.

WORKSPACE.md: третий файл конфигурации

Помимо AGENTS.md и SOUL.md, есть WORKSPACE.md — файл описания рабочего пространства. Он не задаёт поведение, а описывает структуру проекта, чтобы агент понимал «карту» без изучения каждого файла.

# Описание проекта

## Структура директорий

src/
  components/  — React-компоненты
  pages/       — страницы приложения
  utils/       — вспомогательные функции
  types/       — TypeScript-типы

## Ключевые файлы

- src/config/app.ts — глобальная конфигурация
- src/types/api.ts — типы API-ответов
- .env.example — пример переменных окружения

## Команды

- `pnpm dev` — локальный сервер
- `pnpm build` — продакшн-сборка
- `pnpm test` — тесты
- `pnpm deploy` — деплой на прод

Разница между AGENTS.md и system prompt

Технически оба варианта добавляют инструкции в начало каждого запроса. Разница в удобстве и масштабируемости:

	AGENTS.md / SOUL.md	System prompt в конфиге
Хранение	Файл в проекте	JSON-конфиг
Версионирование	Через Git	Ручное
Переключение	По директории	Вручную
Читаемость	Markdown, удобно редактировать	JSON-строка
Командная работа	Легко шарить	Нет

Для регулярной работы — файлы удобнее. System prompt в конфиге подходит для простых одноразовых задач.

Частые ошибки

Ошибка 1: Слишком длинный AGENTS.md

Файл на 1000 строк — это 30-50 тысяч токенов при каждом запросе. Держите инструкции лаконичными. Правило: если можно сформулировать короче — сформулируйте. Агент понимает неполные предложения и маркеры.

Ошибка 2: Противоречия между файлами

Если AGENTS.md говорит «отвечай кратко», а SOUL.md — «давай подробные объяснения», агент будет вести себя непредсказуемо. Сохраняйте единую логику в обоих файлах.

Ошибка 3: Игнорировать контекст проекта

AGENTS.md, написанный год назад под другой проект, может мешать текущей работе. Обновляйте файлы при смене проекта или стека.

Ошибка 4: Не тестировать настройки

После написания AGENTS.md запустите несколько типовых задач и проверьте, ведёт ли агент себя так, как задумано. Часто обнаруживаются неоднозначности, которые нужно уточнить.

Чеклист настройки агента

Отметьте выполненные шаги — прогресс сохраняется в браузере:

• Создан файл AGENTS.md в рабочей директории
• Заполнен раздел «Основные задачи» в AGENTS.md
• Описана рабочая среда (ОС, инструменты, пути)
• Добавлены правила работы (что делать и чего избегать)
• Создан файл SOUL.md с личностью агента
• Выбран тон общения (формальный / неформальный)
• Протестированы настройки на 2–3 типовых задачах
• При необходимости создан WORKSPACE.md с картой проекта

Следующие шаги

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

• Создание собственных навыков — расширение возможностей агента под ваши задачи
• 100 навыков OpenClaw — что агент умеет «из коробки»
• Context overflow — как избежать переполнения контекста при больших файлах конфигурации