--- read_when: - Зміна середовища виконання агента, початкового налаштування робочої області або поведінки сеансу summary: Середовище виконання агента, контракт робочого простору та ініціалізація сеансу title: Виконання агента x-i18n: generated_at: "2026-06-27T17:24:34Z" 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`, якщо його немає, і ініціалізувати файли робочої області. Повний макет робочої області + посібник із резервного копіювання: [Робоча область агента](/uk/concepts/agent-workspace) Якщо `agents.defaults.sandbox` увімкнено, неосновні сеанси можуть перевизначати це за допомогою робочих областей для окремих сеансів у `agents.defaults.sandbox.workspaceRoot` (див. [Конфігурація Gateway](/uk/gateway/configuration)). ## Файли початкового завантаження (інʼєктуються) Усередині `agents.defaults.workspace` OpenClaw очікує ці файли, редаговані користувачем: - `AGENTS.md` - операційні інструкції + "памʼять" - `SOUL.md` - персона, межі, тон - `TOOLS.md` - нотатки про інструменти, які підтримує користувач (наприклад, `imsg`, `sag`, домовленості) - `BOOTSTRAP.md` - одноразовий ритуал першого запуску (видаляється після завершення) - `IDENTITY.md` - імʼя/вайб/емодзі агента - `USER.md` - профіль користувача + бажана форма звертання Під час першого ходу нового сеансу OpenClaw інʼєктує вміст цих файлів у Project Context системного промпта. Порожні файли пропускаються. Великі файли обрізаються й усікаються з маркером, щоб промпти лишалися компактними (прочитайте файл для повного вмісту). Якщо файл відсутній, OpenClaw інʼєктує один рядок-маркер "відсутній файл" (а `openclaw setup` створить безпечний типовий шаблон). `BOOTSTRAP.md` створюється лише для **абсолютно нової робочої області** (коли немає інших файлів початкового завантаження). Поки він очікує на виконання, OpenClaw тримає його в Project Context і додає до системного промпта вказівки щодо початкового ритуалу, замість копіювання його в повідомлення користувача. Якщо ви видалите його після завершення ритуалу, він не має створюватися повторно під час наступних перезапусків. Після того як робочу область було помічено, OpenClaw також зберігає в каталозі стану маркер атестації для шляху робочої області. Якщо нещодавно атестована робоча область зникає або її очищено, запуск відмовляється непомітно повторно засівати `BOOTSTRAP.md`; відновіть робочу область або використайте повне скидання онбордингу, щоб робочу область і маркер було очищено разом. Щоб повністю вимкнути створення файлів початкового завантаження (для попередньо засіяних робочих областей), задайте: ```json5 { agents: { defaults: { skipBootstrap: true } } } ``` ## Вбудовані інструменти Основні інструменти (читання/виконання/редагування/запис і повʼязані системні інструменти) завжди доступні з урахуванням політики інструментів. `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](/uk/gateway/configuration)). ## Межі середовища виконання Вбудоване середовище виконання агента належить OpenClaw: виявлення моделей, підключення інструментів, складання промптів, керування сеансами та доставка каналами мають одну інтегровану поверхню середовища виконання. ## Сеанси Транскрипти сеансів зберігаються як JSONL за адресою: - `~/.openclaw/agents//sessions/.jsonl` Ідентифікатор сеансу стабільний і вибирається OpenClaw. Застарілі папки сеансів з інших інструментів не читаються. ## Керування під час потокового передавання Вхідні промпти, що надходять під час виконання, типово скеровуються в поточне виконання. Керування доставляється **після того, як поточний хід асистента завершує виконання своїх викликів інструментів**, перед наступним викликом LLM, і більше не пропускає решту викликів інструментів із поточного повідомлення асистента. `/queue steer` є типовою поведінкою для активного виконання. `/queue followup` і `/queue collect` змушують повідомлення чекати пізнішого ходу замість керування. `/queue interrupt` натомість перериває активне виконання. Див. [Черга](/uk/concepts/queue) і [Черга керування](/uk/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 передає вивід інструментів через події агента, коли це доступно. Докладніше: [Потокове передавання + розбиття на фрагменти](/uk/concepts/streaming). ## Посилання на моделі Посилання на моделі в конфігурації (наприклад, `agents.defaults.model` і `agents.defaults.models`) розбираються поділом за **першим** `/`. - Використовуйте `provider/model` під час налаштування моделей. - Якщо сам ідентифікатор моделі містить `/` (у стилі OpenRouter), додайте префікс провайдера (приклад: `openrouter/moonshotai/kimi-k2`). - Якщо ви опускаєте провайдера, OpenClaw спочатку пробує alias, потім унікальний збіг налаштованого провайдера для цього точного ідентифікатора моделі, і лише потім повертається до налаштованого типового провайдера. Якщо цей провайдер більше не надає налаштовану типову модель, OpenClaw повертається до першого налаштованого провайдера/моделі замість того, щоб показувати застаріле типове значення видаленого провайдера. ## Конфігурація (мінімальна) Щонайменше задайте: - `agents.defaults.workspace` - `channels.whatsapp.allowFrom` (наполегливо рекомендовано) --- _Далі: [Групові чати](/uk/channels/group-messages)_ 🦞 ## Повʼязане - [Робоча область агента](/uk/concepts/agent-workspace) - [Маршрутизація кількох агентів](/uk/concepts/multi-agent) - [Керування сеансами](/uk/concepts/session)