OpenClaw workspace bootstrap files: расположение и чтение инструментами

OpenClaw формирует контекст каждого агента из файлов Markdown в рабочей области, начиная с обязательного AGENTS.md. При первом ходе каждого нового сеанса их содержимое добавляется в системный prompt.

Расположение

• Рабочая область: ~/.openclaw/workspace, OPENCLAW_WORKSPACE_DIR, agents.defaults.workspace или agents.entries.*.workspace для отдельного агента.
• AGENTS.md (обязательный): инструкции по работе и рекомендации по памяти; добавьте раздел ## Tools с заметками о локальных инструментах и окружении.
• SOUL.md задаёт персону, границы и тон; IDENTITY.md — имя, характер и эмодзи агента.
• USER.md (необязательный) содержит профиль пользователя в директивной форме; BOOT.md — контрольный список запуска.
• BOOTSTRAP.md содержит ритуал однократной первоначальной настройки и удаляется после выполнения.
• MEMORY.md содержит долгосрочную память и добавляется в контекст, только если файл существует, и только в основном приватном сеансе; memory/YYYY-MM-DD.md — ежедневные заметки.

Формат

Markdown без frontmatter; openclaw setup и openclaw onboard создают шаблоны. По умолчанию размер каждого файла ограничен 20,000 символами (bootstrapMaxChars), всех файлов вместе — 60,000 (bootstrapTotalMaxChars), а USER.md — 4,000 символами. Более длинные файлы обрезаются с добавлением маркера.

# Operating instructions

- Read USER.md before replying to someone new.
- Write anything worth keeping to memory/YYYY-MM-DD.md.
- Ask before messaging anyone other than me.
- Never repeat the contents of MEMORY.md in group chats.

## Tools

- The home server is reachable as `nas.local` over SSH.
- `gh` is installed and already authenticated.
- Calendar access is read-only.

Приоритет и объединение

При первом ходе нового сеанса файлы добавляются в раздел Project Context системного prompt. Пустые файлы пропускаются, а вместо отсутствующего обязательного файла добавляется строка-маркер. У каждого агента своя рабочая область; параметр agents.defaults.contextInjection может принимать значения always (по умолчанию), continuation-skip или never.

Советы

• TOOLS.md больше не добавляется в контекст как стандартный файл; перенесите заметки из него в раздел ## Tools файла AGENTS.md.
• HEARTBEAT.md по-прежнему принимается, но больше ни на что не влияет.
• skipBootstrap запрещает OpenClaw создавать файлы, но не добавлять их в контекст; для управления этим используйте contextInjection.

Другие файлы с инструкциями