🧠 Память агента: Memory Stack — полная архитектура
Создано: 02.05.2026 | Автор: Элис | Версия: 1.1.0
OpenClaw запускает один встроенный agent runtime на Gateway — один процесс-агент с собственным workspace, bootstrap-файлами и session store. Агент — это полностью изолированный «мозг»:
По умолчанию OpenClaw работает в single-agent режиме: agentId = "main", workspace ~/.openclaw/workspace. В multi-agent режиме каждый agentId — полностью изолированная персона с собственным workspace, каналами и памятью.
На каждом старте сессии OpenClaw инжектит содержимое этих файлов в контекст модели (под Project Context):
| Файл | Назначение | Инжектится | Обязателен |
|---|---|---|---|
| SOUL.md | Личность, тон, границы, vibe | ✅ Всегда (кроме sub-agent) | Нет |
| IDENTITY.md | Метаданные: имя, роль, эмодзи | ✅ Всегда (кроме sub-agent) | Нет |
| AGENTS.md | Операционные правила, workspace-конвенции | ✅ Всегда + sub-agent | Нет |
| USER.md | Профиль человека (владельца) | ✅ Всегда (кроме sub-agent) | Нет |
| TOOLS.md | Пользовательские заметки по инструментам | ✅ Всегда + sub-agent | Нет |
| HEARTBEAT.md | Чек-листы, cron-задачи, proactive guard | ✅ Когда heartbeat включён | Нет |
| BOOTSTRAP.md | Ритуал первого запуска | ✅ Только на новом workspace | Нет |
| MEMORY.md | Долговременная память | ✅ Только в main-сессии | Нет |
bootstrapMaxChars (default: 12000 символов на файл)bootstrapTotalMaxChars (default: 60000 символов)AGENTS.md и TOOLS.mdSOUL.md → характер, личность, манера общенияAGENTS.md → правила работы, red lines, стандартыIDENTITY.md → базовые метаданные (имя, эмодзи)MEMORY.md → долговременный контекст (только main-сессия, не групповые чаты)SOUL.md имеет приоритет над AGENTS.md в вопросах личности, но безопасность (AGENTS.md) переопределяет всё.
Агент имеет доступ к набору built-in tools и skills.
read, edit, write — работа с файламиexec, process — выполнение командmemory_search, memory_get — работа с памятьюweb_search, web_fetch — интернетbrowser — управление браузеромmessage — отправка сообщенийsessions_* — меж-агентская связьcron — отложенные задачиgateway — управление конфигомSkills — это файлы SKILL.md, которые расширяют возможности агента. Загружаются из:
<workspace>/skills~/.openclaw/skillsSkills не инжектятся автоматом. Агент читает SKILL.md через read только когда skill нужен.
Инструменты «стоят» контекста:
/context detail показывает топ самых тяжёлых tool schemas.
Полностью изолированный brain с собственным:
sessions_send — отправить сообщение другому агентуsessions_spawn — породить sub-agentagents_list — список доступных агентовТребует tools.agentToAgent.enabled: true и tools.agentToAgent.allow в конфиге.
Sub-agents запускаются как изолированные сессии с promptMode: "minimal":
| Компонент | Где живёт | Назначение | Когда активен |
|---|---|---|---|
| SOUL.md | Workspace | Личность, тон | Каждый run (full) |
| AGENTS.md | Workspace | Правила работы | Всегда |
| MEMORY.md | Workspace | Долгая память | Только main-сессия |
| memory/*.md | Workspace/memory/ | Дневной контекст | Автоинжект сегодня+вчера |
| HEARTBEAT.md | Workspace | Proactive guard | Только heartbeat run |
| System Prompt | OpenClaw-owned | Инструкции, тулы, контекст | Каждый run |
| Session History | ~/.openclaw/agents/.../sessions/ | История диалога | В контексте сессии |
| Skills | workspace/skills/ + bundled | Расширение возможностей | По требованию (read) |
| Tools | Built-in + plugin | Действия | Subject to policy |