---
read_when:
    - Розуміння того, що відбувається під час першого запуску агента
    - Пояснення розташування файлів початкового налаштування
    - Налагодження налаштування ідентичності під час початкового налаштування
sidebarTitle: Bootstrapping
summary: Ритуал початкового налаштування агента, що створює файли робочого простору та ідентичності
title: Початкове налаштування агента
x-i18n:
    generated_at: "2026-07-12T13:49:03Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: d8356684e8567b02f558ce2b455a20019e55579e5dcb4625bb441d66656098e0
    source_path: start/bootstrapping.md
    workflow: 16
---

Початкове налаштування — це ритуал першого запуску, який наповнює новий робочий простір агента початковими файлами та
допомагає агенту вибрати ідентичність. Він виконується один раз, одразу після
вступного налаштування, під час першої повноцінної взаємодії агента.

## Що відбувається

Під час першого запуску з цілком новим робочим простором (типово `~/.openclaw/workspace`)
OpenClaw:

- Створює початкові файли `AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md` і `BOOTSTRAP.md`.
- Доручає агенту дотримуватися `BOOTSTRAP.md`: провести розмову у вільній формі (а не за фіксованою формою запитань і відповідей), щоб визначити ім’я, особистість і стиль.
- Записує отримані відомості у `IDENTITY.md`, `USER.md` і `SOUL.md`.
- Видаляє `BOOTSTRAP.md`, щойно робочий простір виглядає налаштованим, тому ритуал виконується лише один раз.

Робочий простір вважається налаштованим, коли `SOUL.md`, `IDENTITY.md` або `USER.md`
відрізняється від початкового шаблону або існує папка `memory/`.

<Note>
`BOOTSTRAP.md` охоплює всю розмову про ідентичність. Його вміст наведено в
[шаблоні BOOTSTRAP.md](/uk/reference/templates/BOOTSTRAP).
</Note>

## Запуски із вбудованими й локальними моделями

Для запусків із вбудованими або локальними моделями OpenClaw не додає `BOOTSTRAP.md` до
привілейованого системного контексту. Під час першого основного інтерактивного запуску він усе одно
передає вміст файлу через запит користувача, щоб моделі, які
не завжди належним чином викликають інструмент `read`, також могли завершити ритуал. Якщо поточний
запуск не може безпечно отримати доступ до робочого простору, агент замість загального привітання
отримує коротку примітку про обмежене початкове налаштування.

## Пропуск початкового налаштування

Щоб пропустити його для заздалегідь підготовленого робочого простору, виконайте:

```bash
openclaw onboard --skip-bootstrap
```

## Де воно виконується

Початкове налаштування завжди виконується на хості Gateway. Якщо застосунок macOS підключається до
віддаленого Gateway, робочий простір і файли початкового налаштування зберігаються на цій віддаленій
машині, а не на Mac.

<Note>
Коли Gateway працює на іншій машині, редагуйте файли робочого простору на хості Gateway
(наприклад, `user@gateway-host:~/.openclaw/workspace`).
</Note>

## Пов’язана документація

- Вступне налаштування застосунку macOS: [Вступне налаштування](/uk/start/onboarding)
- Структура робочого простору: [Робочий простір агента](/uk/concepts/agent-workspace)
- Вміст шаблону: [Шаблон BOOTSTRAP.md](/uk/reference/templates/BOOTSTRAP)