--- read_when: - Изменение среды выполнения агента, начальной настройки рабочей области или поведения сессии summary: Среда выполнения агента, контракт рабочей области и начальная загрузка сеанса title: Среда выполнения агента x-i18n: generated_at: "2026-06-28T22:48:18Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 2fb4d3f0bb6e8aa2a23d00f5def5eb0ffa152bc75f82a12c40ac7ed00776011c source_path: concepts/agent.md workflow: 16 --- 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 { agents: { defaults: { skipBootstrap: true } } } ``` ## Встроенные инструменты Основные инструменты (read/exec/edit/write и связанные системные инструменты) всегда доступны, с учетом политики инструментов. `apply_patch` является необязательным и управляется `tools.exec.applyPatch`. `TOOLS.md` **не** управляет тем, какие инструменты существуют; это руководство о том, как _вы_ хотите, чтобы они использовались. ## Skills OpenClaw загружает Skills из этих расположений (сначала наивысший приоритет): - Рабочее пространство: `/skills` - Skills агента проекта: `/.agents/skills` - Личные Skills агента: `~/.agents/skills` - Управляемые/локальные: `~/.openclaw/skills` - Встроенные (поставляются с установкой) - Дополнительные папки Skills: `skills.load.extraDirs` Корни Skills могут содержать сгруппированные папки, такие как `/skills/personal/foo/SKILL.md`; Skill по-прежнему предоставляется по своему плоскому имени из frontmatter, например `foo`. Skills могут ограничиваться конфигурацией/env (см. `skills` в [Конфигурации Gateway](/ru/gateway/configuration)). ## Границы среды выполнения Встроенная среда выполнения агента принадлежит OpenClaw: обнаружение моделей, подключение инструментов, сборка промпта, управление сеансами и доставка в каналы используют единую интегрированную поверхность среды выполнения. ## Сеансы Транскрипты сеансов хранятся как JSONL по пути: - `~/.openclaw/agents//sessions/.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)