Початкове налаштування агента

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

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

Під час першого запуску з цілком новим робочим простором (типово ~/.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/.

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

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

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

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

openclaw onboard --skip-bootstrap

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

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

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

• Вступне налаштування застосунку macOS: Вступне налаштування
• Структура робочого простору: Робочий простір агента
• Вміст шаблону: Шаблон BOOTSTRAP.md