Инициализация агента

Инициализация — это ритуал первого запуска, который подготавливает новое рабочее пространство агента и помогает агенту выбрать свою идентичность. Он выполняется один раз, сразу после первоначальной настройки, во время первого полноценного хода агента.

Что происходит

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