OpenClaw 2026.10.2: что лежит в рабочей папке агента и что там править

Коротко

Рабочая папка по умолчанию: ~/.openclaw/workspace. Переопределяется через agents.defaults.workspace, OPENCLAW_WORKSPACE_DIR или OPENCLAW_PROFILE.
В раздел Project Context системного промпта на первом ходу новой сессии загружаются AGENTS.md, SOUL.md, IDENTITY.md, USER.md, BOOTSTRAP.md и (если есть) MEMORY.md.
BOOTSTRAP.md создаётся только один раз для совсем новой рабочей папки и удаляется вручную после ритуала. Setup не перетирает уже существующие файлы.

Сверено с документацией OpenClaw 2026.10.2, 13 октября 2026.

Рабочая папка агента — это его «дом»: каталог для файловых инструментов и контекста. Она отдельная от ~/.openclaw/, где лежат конфиг и состояние. Здесь — какие файлы загружаются в системный промпт, что OpenClaw перепишет сам, а что стоит бэкапить.

Что лежит в рабочей папке

По умолчанию это ~/.openclaw/workspace. Если задан OPENCLAW_PROFILE (не default), путь становится ~/.openclaw-<profile>/workspace. Переменная OPENCLAW_WORKSPACE_DIR перекрывает оба варианта. В мультиагентной конфигурации агенты без своего workspace садятся в подпапки базового корня или в <state-dir>/workspace-<agentId>.

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}

Команды openclaw onboard, openclaw configure и openclaw setup создают папку и засевают файлы, если их нет. Чтобы отключить автосоздание (например, рабочая папка уже ваша с собственным git), поставьте так:

{ agents: { defaults: { skipBootstrap: true } } }

Как рабочая папка попадает в системный промпт

OpenClaw сам собирает системный промпт для каждого запуска. Раздел Project Context подгружает содержимое файлов рабочей папки на первом ходу новой сессии: AGENTS.md (правила и приоритеты), SOUL.md (персона и тон), IDENTITY.md (имя, вайб, эмодзи), USER.md (директивный профиль пользователя со своим бюджетом 4000 символов). MEMORY.md подключается только если лежит в корне рабочей папки; пустые файлы пропускаются, на месте отсутствующих обязательных файлов вставляется маркер «missing file», а опциональные USER.md и MEMORY.md просто пропускаются.

Большие файлы усекаются по лимитам agents.defaults.bootstrapMaxChars (по умолчанию 20000) и agents.defaults.bootstrapTotalMaxChars (60000). Раздел системного промпта Workspace дополнительно содержит путь к рабочей папке, а раздел Workspace Files (injected) сообщает модели, что ниже подгружены файлы.

Что перезаписывается при старте

BOOTSTRAP.md создаётся только для совсем новой рабочей папки, где нет других таких файлов. После ритуала его удаляют вручную, и тогда он больше не появляется. Если рабочая папка уже аттестована, OpenClaw не пересоздаёт BOOTSTRAP.md молча.
IDENTITY.md обновляется во время ритуала первого запуска вместе с другими файлами.
Шаблонные файлы: openclaw setup создаёт безопасные шаблоны для отсутствующих файлов и не перетирает уже существующие.

IDENTITY.md ритуал первого запуска заполняет сам, но это обычный редактируемый файл: имя, вайб и эмодзи можно поправить руками в любой момент. BOOTSTRAP.md после ритуала удалите, и он больше не появится. Правила держите в AGENTS.md, профиль пользователя — в USER.md, долгие заметки — в memory/YYYY-MM-DD.md и MEMORY.md.

Что править руками и как бэкапить

Под ваше управление отдаются AGENTS.md, SOUL.md, USER.md, MEMORY.md, memory/YYYY-MM-DD.md и skills/. Рабочую папку держат как закрытое хранилище: кладите её в приватный git-репозиторий прямо на машине, где работает Gateway.

В репозиторий рабочей папки не кладут всё, что лежит под ~/.openclaw/: openclaw.json, state/openclaw.sqlite, agents/<agentId>/agent/openclaw-agent.sqlite, agents/<agentId>/agent/codex-home/, credentials/, agents/<agentId>/sessions/, skills/ управляемых скиллов. Эти данные переносите отдельно и не коммитьте.

Если включена песочница и workspaceAccess не равен "rw", инструменты работают не в вашей рабочей папке, а в копии под ~/.openclaw/sandboxes: учитывайте это при бэкапе. Старые служебные файлы (openclaw-workspace-state.json, .attested) рантайм больше не читает. Нашли их, прогоните openclaw doctor --fix: он перенесёт валидное состояние в SQLite.

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

Считают рабочую папку песочницей и кладут туда чувствительные данные. По умолчанию это просто рабочий каталог: абсолютные пути уводят за пределы папки, изоляцию даёт только agents.defaults.sandbox.
Переключают агента на старый ~/openclaw, не остановив Gateway и не прогнав openclaw doctor --fix: лишние папки не сливаются с активной рабочей папкой, и агент перестаёт видеть персону и память из той, на которую вы переключились не до конца.
Забывают, что MEMORY.md грузится только из корня рабочей папки и только в приватной основной сессии. Подробные логи кладите в memory/YYYY-MM-DD.md, чтобы инструменты памяти доставали их по запросу, а не на каждом ходу.
Коммитят в репозиторий рабочей папки содержимое ~/.openclaw/, включая credentials/ и файлы openclaw.sqlite.