> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Среда выполнения агента

OpenClaw запускает **единую встроенную среду выполнения агента** - один процесс агента на
Gateway, с собственным рабочим пространством, файлами начальной загрузки и хранилищем сеансов. Эта страница
описывает контракт этой среды выполнения: что должно содержать рабочее пространство, какие файлы
внедряются и как сеансы выполняют начальную загрузку относительно него.

## Рабочее пространство (обязательно)

OpenClaw использует единый каталог рабочего пространства агента (`agents.defaults.workspace`) как **единственный** рабочий каталог агента (`cwd`) для инструментов и контекста.

Рекомендуется: используйте `openclaw setup`, чтобы создать `~/.openclaw/openclaw.json`, если он отсутствует, и инициализировать файлы рабочего пространства.

Полная схема рабочего пространства и руководство по резервному копированию: [Рабочее пространство агента](/ru/concepts/agent-workspace)

Если `agents.defaults.sandbox` включен, неосновные сеансы могут переопределить это
рабочими пространствами для отдельных сеансов в `agents.defaults.sandbox.workspaceRoot` (см.
[Конфигурация Gateway](/ru/gateway/configuration)).

## Файлы начальной загрузки (внедряются)

Внутри `agents.defaults.workspace` OpenClaw ожидает эти редактируемые пользователем файлы:

* `AGENTS.md` - рабочие инструкции + «память»
* `SOUL.md` - персона, границы, тон
* `TOOLS.md` - поддерживаемые пользователем заметки об инструментах (например, `imsg`, `sag`, соглашения)
* `BOOTSTRAP.md` - одноразовый ритуал первого запуска (удаляется после завершения)
* `IDENTITY.md` - имя агента/вайб/эмодзи
* `USER.md` - профиль пользователя + предпочтительное обращение

На первом ходе нового сеанса OpenClaw внедряет содержимое этих файлов в контекст проекта системного промпта.

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

Если файл отсутствует, OpenClaw внедряет одну строку-маркер «файл отсутствует» (а `openclaw setup` создаст безопасный шаблон по умолчанию).

`BOOTSTRAP.md` создается только для **совершенно нового рабочего пространства** (когда других файлов начальной загрузки нет). Пока он ожидает выполнения, OpenClaw сохраняет его в контексте проекта и добавляет в системный промпт указания по начальной загрузке для первоначального ритуала, вместо того чтобы копировать его в сообщение пользователя. Если вы удалите его после завершения ритуала, он не должен создаваться заново при последующих перезапусках.

После того как рабочее пространство было зафиксировано, OpenClaw также хранит в каталоге состояния маркер аттестации для пути рабочего пространства. Если недавно аттестованное рабочее пространство исчезает или очищается, запуск отказывается тихо заново засевать `BOOTSTRAP.md`; восстановите рабочее пространство или выполните полный сброс онбординга, чтобы рабочее пространство и маркер были очищены вместе.

Чтобы полностью отключить создание файлов начальной загрузки (для заранее подготовленных рабочих пространств), задайте:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{ agents: { defaults: { skipBootstrap: true } } }
```

## Встроенные инструменты

Основные инструменты (read/exec/edit/write и связанные системные инструменты) всегда доступны,
с учетом политики инструментов. `apply_patch` является необязательным и управляется
`tools.exec.applyPatch`. `TOOLS.md` **не** управляет тем, какие инструменты существуют; это
руководство о том, как *вы* хотите, чтобы они использовались.

## Skills

OpenClaw загружает Skills из этих расположений (сначала наивысший приоритет):

* Рабочее пространство: `<workspace>/skills`
* Skills агента проекта: `<workspace>/.agents/skills`
* Личные Skills агента: `~/.agents/skills`
* Управляемые/локальные: `~/.openclaw/skills`
* Встроенные (поставляются с установкой)
* Дополнительные папки Skills: `skills.load.extraDirs`

Корни Skills могут содержать сгруппированные папки, такие как
`<workspace>/skills/personal/foo/SKILL.md`; Skill по-прежнему предоставляется по своему
плоскому имени из frontmatter, например `foo`.

Skills могут ограничиваться конфигурацией/env (см. `skills` в [Конфигурации Gateway](/ru/gateway/configuration)).

## Границы среды выполнения

Встроенная среда выполнения агента принадлежит OpenClaw: обнаружение моделей, подключение инструментов,
сборка промпта, управление сеансами и доставка в каналы используют единую интегрированную
поверхность среды выполнения.

## Сеансы

Транскрипты сеансов хранятся как JSONL по пути:

* `~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl`

ID сеанса стабилен и выбирается OpenClaw.
Устаревшие папки сеансов из других инструментов не читаются.

## Направление во время потоковой передачи

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

`/queue steer` является поведением активного запуска по умолчанию. `/queue followup` и
`/queue collect` заставляют сообщения ждать более позднего хода вместо направления.
`/queue interrupt` вместо этого прерывает активный запуск. См. [Очередь](/ru/concepts/queue)
и [Очередь направления](/ru/concepts/queue-steering), чтобы узнать о поведении очереди и границ.

Потоковая передача блоков отправляет завершенные блоки ассистента сразу после их завершения; она
**выключена по умолчанию** (`agents.defaults.blockStreamingDefault: "off"`).
Настройте границу через `agents.defaults.blockStreamingBreak` (`text_end` или `message_end`; по умолчанию text\_end).
Управляйте мягким разбиением блоков на фрагменты с помощью `agents.defaults.blockStreamingChunk` (по умолчанию
800-1200 символов; предпочитает разрывы абзацев, затем новые строки; предложения в последнюю очередь).
Объединяйте потоковые фрагменты с помощью `agents.defaults.blockStreamingCoalesce`, чтобы уменьшить
спам одиночными строками (объединение перед отправкой на основе простоя). Каналам не Telegram требуется
явное `*.blockStreaming: true`, чтобы включить ответы блоками.
Подробные сводки инструментов выводятся при старте инструмента (без debounce); Control UI
передает вывод инструмента через события агента, когда они доступны.
Подробнее: [Потоковая передача и разбиение на фрагменты](/ru/concepts/streaming).

## Ссылки на модели

Ссылки на модели в конфигурации (например, `agents.defaults.model` и `agents.defaults.models`) разбираются разделением по **первому** `/`.

* Используйте `provider/model` при настройке моделей.
* Если сам ID модели содержит `/` (в стиле OpenRouter), включите префикс провайдера (пример: `openrouter/moonshotai/kimi-k2`).
* Если вы опускаете провайдера, OpenClaw сначала пробует псевдоним, затем уникальное
  совпадение настроенного провайдера для этого точного ID модели и только после этого возвращается
  к настроенному провайдеру по умолчанию. Если этот провайдер больше не предоставляет
  настроенную модель по умолчанию, OpenClaw возвращается к первой настроенной
  паре провайдер/модель вместо того, чтобы показывать устаревшее значение по умолчанию удаленного провайдера.

## Конфигурация (минимальная)

Как минимум задайте:

* `agents.defaults.workspace`
* `channels.whatsapp.allowFrom` (настоятельно рекомендуется)

***

*Далее: [Групповые чаты](/ru/channels/group-messages)* 🦞

## Связанные материалы

* [Рабочее пространство агента](/ru/concepts/agent-workspace)
* [Маршрутизация нескольких агентов](/ru/concepts/multi-agent)
* [Управление сеансами](/ru/concepts/session)