До версии 2026.4.7 память OpenClaw была ephemeral: сессия завершилась — контекст исчез. Агент начинал каждый новый разговор без знания о предыдущих задачах, ваших предпочтениях, результатах прошлых экспериментов. Это принципиально отличало его от человека-коллеги, который помнит, что обсуждали на прошлой неделе.
Версия 4.7 изменила архитектуру памяти. Теперь OpenClaw имеет три уровня хранения знаний с разными свойствами. Разобраться в них — значит научить агента накапливать ценность со временем, а не начинать с нуля каждый раз.
Три уровня памяти OpenClaw
| Уровень | Файл / механизм | Тип | Кто пишет | Когда сбрасывается |
|---|---|---|---|---|
| Контекст сессии | In-memory | Краткосрочный | Автоматически | При завершении сессии |
| Конфигурационные файлы | SOUL.md, WORKSPACE.md, AGENTS.md | Статический | Пользователь | Только при ручном изменении |
| memory-wiki | ~/.openclaw/wiki/ | Динамический | Агент + пользователь | Не сбрасывается |
Ключевое отличие: конфигурационные файлы — это то, что вы задаёте агенту. memory-wiki — это то, что агент узнаёт сам в процессе работы.
Контекст сессии: что это и его ограничения
Контекст сессии — всё, что агент помнит в рамках одного разговора: ваши сообщения, результаты инструментов, промежуточные выводы. Он существует в оперативной памяти и исчезает, как только сессия завершается.
Ограничения:
- Конечный размер (context window модели)
- Не переживает перезапуск агента
- Не доступен другим экземплярам агента
Для работы с переполнением контекста в рамках сессии — отдельный материал: Context overflow: решение.
SOUL.md: личность и жёсткие ограничения
SOUL.md — статический конфигурационный файл, который загружается при каждом старте сессии. Он определяет характер агента: тон общения, приоритеты, роль, жёсткие запреты.
# soul.md — пример для личного продуктивного агента
## Личность
Ты — Алекс, помощник для управления проектами и исследований.
Ты конкретен, избегаешь лишних слов, предлагаешь решения, а не только анализ.
## Приоритеты
1. Точность важнее скорости
2. Предлагай варианты, а не единственное решение
3. Уточняй неоднозначные задачи перед выполнением
## Жёсткие ограничения (не нарушать никогда)
- Не удалять файлы без явного подтверждения
- Не отправлять сообщения от моего имени без подтверждения
- Не работать с финансовыми данными без явного запроса
- Не устанавливать новые скиллы без моего одобрения
## Рабочий стиль
- Отвечай на русском, если я пишу на русском
- Для кода — TypeScript или Python, не спрашивая
- При неясности — задай один уточняющий вопросSOUL.md подробно описан в статье AGENTS.md и SOUL.md: настройка личности.
Чем SOUL.md отличается от memory-wiki: SOUL.md — это то, что вы сознательно задаёте и редко меняете. memory-wiki — это то, что агент открывает сам, накапливая опыт.
memory-wiki: динамическая база знаний (новое в v4.7)
Что это
memory-wiki — это набор Markdown-файлов в ~/.openclaw/wiki/, которые агент читает при старте каждой сессии и дополняет в процессе работы. Это не просто логи — это структурированные знания о вас, ваших проектах и предпочтениях.
~/.openclaw/wiki/
├── user-preferences.md # Ваши предпочтения в работе
├── projects/
│ ├── infoclaw-ru.md # Контекст проекта
│ └── client-crm.md # Другой проект
├── contacts/
│ └── team.md # Информация о команде
└── knowledge/
├── tools.md # Предпочитаемые инструменты
└── decisions.md # Принятые архитектурные решенияКак агент пишет в wiki
Агент может записывать в memory-wiki явно (по вашей команде) или автоматически (если настроен).
Явная запись:
Вы: Запомни: в этом проекте мы используем snake_case для переменных Python
и camelCase для TypeScript. Обновляй wiki.
Агент: Записал в ~/.openclaw/wiki/projects/api-project.md:
"Соглашение по именованию: snake_case для Python, camelCase для TypeScript.
Установлено: 2026-04-15."Автоматическая запись — настраивается в SOUL.md:
## Политика памяти
После каждой сессии:
- Если узнал новое предпочтение пользователя — запиши в wiki/user-preferences.md
- Если принято архитектурное решение — запиши в wiki/projects/[проект]/decisions.md
- Если выяснилась новая деталь о команде — wiki/contacts/team.md
- Не записывай временные данные и промежуточные результатыКак агент читает из wiki
При старте каждой сессии агент автоматически загружает содержимое wiki в свой начальный контекст. Вы можете проверить, что загружено:
openclaw wiki list # Список файлов wiki
openclaw wiki show user-preferences # Показать конкретный файл
openclaw wiki stats # Статистика использованияПример: как агент «выучил» ваши предпочтения за 2 недели
После двух недель работы ~/.openclaw/wiki/user-preferences.md может выглядеть так:
# Предпочтения пользователя
## Стиль коммуникации
- Предпочитает короткие ответы (проверено 2026-04-01)
- Не любит объяснений очевидного
- Ценит конкретные примеры кода
## Рабочие паттерны
- Активен с 9:00 до 18:00 MSK
- Делает перерывы в 13:00-14:00
- Утром — стратегические задачи, вечером — рутина
## Технические предпочтения
- Редактор: VS Code с vim-биндингами
- Язык по умолчанию: Python для скриптов, TypeScript для веба
- Форматтер: prettier с tabWidth: 2
- Тесты: vitest для TypeScript, pytest для Python
## Проекты
- Приоритет 1: infoclaw.ru (контент-сайт)
- Приоритет 2: client-api (рабочий проект)
- infoclaw.ru деплоится через GitHub Actions на BegetOpenClaw Dreaming: фоновая консолидация памяти
OpenClaw Dreaming — механизм, который работает в фоне, когда агент не занят активными задачами. Он анализирует накопленные данные сессий, выявляет паттерны и консолидирует знания в memory-wiki.
Аналогия: как человеческий мозг обрабатывает информацию во время сна — не выполняет задачи, а упорядочивает опыт.
Что делает Dreaming
- Дедупликация — объединяет похожие записи в wiki
- Устаревшие факты — помечает или удаляет информацию, которая противоречит более новым данным
- Выявление паттернов — если вы 10 раз просили агента форматировать код определённым образом, Dreaming записывает это как предпочтение
- Структурирование — упорядочивает разрозненные записи в связную базу знаний
Включение Dreaming
// openclaw.json
{
"dreaming": {
"enabled": true,
"schedule": "0 3 * * *", // Каждую ночь в 3:00
"max_duration_minutes": 30,
"targets": ["wiki/user-preferences.md", "wiki/projects/"]
}
}Что происходит во время Dreaming
[03:00] OpenClaw Dreaming начался
[03:01] Анализ 47 сессий за последние 7 дней
[03:04] Обнаружен паттерн: пользователь 8 из 10 раз выбирал async/await над промисами
[03:05] Обновлён wiki/user-preferences.md: добавлено предпочтение async/await
[03:07] Устаревшая запись о npm 8 заменена на npm 10 (подтверждено 5 раз)
[03:09] Создан новый файл wiki/projects/infoclaw-ru.md на основе 12 сессий
[03:12] Дедупликация: объединены 3 похожие записи о рабочем стиле
[03:13] OpenClaw Dreaming завершён. Изменено 4 файла, создан 1 новыйCross-session persistence: техническая настройка
По умолчанию memory-wiki хранится локально в ~/.openclaw/wiki/. Для командного использования или деплоя на нескольких машинах можно настроить внешний storage backend.
Синхронизация через Git
// openclaw.json
{
"wiki": {
"storage": "git",
"repo": "git@github.com:yourorg/openclaw-wiki.git",
"branch": "main",
"sync_interval": "15m"
}
}Это позволяет нескольким агентам (например, на VPS и на ноутбуке) использовать одну базу знаний.
Командная база знаний
{
"wiki": {
"storage": "git",
"repo": "git@github.com:yourorg/team-knowledge.git",
"namespaces": {
"shared": "wiki/team/", // Общее — читают все агенты
"private": "wiki/personal/" // Личное — только этот агент
}
}
}Таблица: что хранить где
| Тип информации | SOUL.md | WORKSPACE.md | memory-wiki | context сессии |
|---|---|---|---|---|
| Тон и стиль общения | ✅ | ❌ | ❌ | ❌ |
| Жёсткие запреты | ✅ | ❌ | ❌ | ❌ |
| Роль агента | ✅ | ❌ | ❌ | ❌ |
| Структура проекта | ❌ | ✅ | ❌ | ❌ |
| Команды для запуска | ❌ | ✅ | ❌ | ❌ |
| Соглашения по коду | ❌ | ✅ | ✅ (узнанные) | ❌ |
| Предпочтения пользователя | ❌ | ❌ | ✅ | ❌ |
| Принятые решения | ❌ | ❌ | ✅ | ❌ |
| Контекст команды | ❌ | ❌ | ✅ | ❌ |
| Результаты текущей задачи | ❌ | ❌ | ❌ | ✅ |
| Промежуточные шаги | ❌ | ❌ | ❌ | ✅ |
Правило большого пальца: если информация нужна один раз — в контексте. Если нужна регулярно, но редко меняется — в SOUL.md / WORKSPACE.md. Если агент узнаёт это в процессе работы — в memory-wiki.
Управление памятью: полезные команды
# Просмотр содержимого wiki
openclaw wiki list
openclaw wiki show user-preferences
# Ручное добавление записи
openclaw wiki add "user-preferences" "Предпочитает TypeScript 5.x с strict mode"
# Поиск по wiki
openclaw wiki search "TypeScript"
# Экспорт всей wiki
openclaw wiki export --format markdown --output ./wiki-backup/
# Очистка устаревших записей (интерактивно)
openclaw wiki cleanup --interactive
# Запустить Dreaming вручную
openclaw dream --nowПриватность: что важно знать
memory-wiki хранится локально по умолчанию (~/.openclaw/wiki/). Anthropic, OpenAI и другие провайдеры моделей не имеют доступа к вашей wiki — она не передаётся в API-запросах (только если вы явно не включите это).
Исключение: если настроен git-backend на публичном репозитории — данные будут там. Для командных баз знаний используйте приватные репозитории.
Перед настройкой командной wiki проконсультируйтесь с материалом Enterprise Security о правильном хранении корпоративных знаний.
Система памяти — одна из ключевых причин, по которой OpenClaw v4.7 качественно отличается от предыдущих версий. Агент, который помнит — это принципиально другой инструмент, чем агент, который начинает с нуля каждый раз.