Перейти к основному содержимому

Основы

Системный промпт

OpenClaw создает пользовательский системный промпт для каждого запуска агента. Промпт принадлежит OpenClaw и не использует промпт по умолчанию от pi-coding-agent. Промпт собирается OpenClaw и внедряется в каждый запуск агента.

Структура​

Промпт намеренно компактен и использует фиксированные разделы:

  • Инструменты: текущий список инструментов + краткие описания.
  • Безопасность: краткое напоминание о защитных ограничениях, чтобы избежать поведения, направленного на захват контроля, или обхода надзора.
  • Навыки (при наличии): сообщает модели, как загружать инструкции навыков по запросу.
  • Самообновление OpenClaw: как запустить config.apply и update.run.
  • Рабочее пространство: рабочая директория (agents.defaults.workspace).
  • Документация: локальный путь к документации OpenClaw (репозиторий или npm-пакет) и когда её читать.
  • Файлы рабочего пространства (внедрены): указывает, что файлы начальной загрузки включены ниже.
  • Песочница (при включении): указывает на изолированную среду выполнения, пути в песочнице и доступность повышенных привилегий выполнения.
  • Текущая дата и время: локальное время пользователя, часовой пояс и формат времени.
  • Теги ответов: необязательный синтаксис тегов ответов для поддерживаемых провайдеров.
  • Пульс: промпт пульса и поведение подтверждения.
  • Среда выполнения: хост, ОС, node, модель, корень репозитория (при обнаружении), уровень мышления (одна строка).
  • Рассуждения: текущий уровень видимости + подсказка о переключении /reasoning.

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

Режимы промптов​

OpenClaw может формировать более короткие системные промпты для суб-агентов. Среда выполнения устанавливает promptMode для каждого запуска (это не настройка, доступная пользователю):

  • full (по умолчанию): включает все разделы, перечисленные выше.
  • minimal: используется для суб-агентов; опускает разделы Навыки, Воспоминания, Самообновление OpenClaw, Псевдонимы моделей, Идентификатор пользователя, Теги ответов, Обмен сообщениями, Тихие ответы и Пульс. Инструменты, Безопасность, Рабочее пространство, Песочница, Текущая дата и время (когда известны), Среда выполнения и внедренный контекст остаются доступными.
  • none: возвращает только базовую строку идентификации.

Когда promptMode=minimal, дополнительные внедренные промпты помечаются как Контекст суб-агента вместо Контекст группового чата.

Внедрение начальной загрузки рабочего пространства​

Файлы начальной загрузки обрезаются и добавляются в раздел Контекст проекта, чтобы модель видела контекст идентификации и профиля без необходимости явного чтения:

  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md (только в совершенно новых рабочих пространствах)
  • MEMORY.md и/или memory.md (при наличии в рабочем пространстве; может быть внедрен один или оба)

Все эти файлы внедряются в контекстное окно на каждом шаге, что означает, что они расходуют токены. Держите их краткими — особенно MEMORY.md, который может расти со временем и приводить к неожиданно высокому использованию контекста и более частому сжатию.

Примечание: Ежедневные файлы memory/*.md не внедряются автоматически. Доступ к ним осуществляется по запросу через инструменты memory_search и memory_get, поэтому они не учитываются в контекстном окне, если модель явно их не читает.

Большие файлы обрезаются с маркером. Максимальный размер на файл контролируется параметром agents.defaults.bootstrapMaxChars (по умолчанию: 20000). Общий объем внедренного контента начальной загрузки по всем файлам ограничен параметром agents.defaults.bootstrapTotalMaxChars (по умолчанию: 150000). Отсутствующие файлы внедряют короткий маркер об отсутствии файла. При обрезке OpenClaw может внедрить блок предупреждения в Контекст проекта; управляйте этим с помощью agents.defaults.bootstrapPromptTruncationWarning (off, once, always; по умолчанию: once). Сессии суб-агентов внедряют только AGENTS.md и TOOLS.md (другие файлы начальной загрузки отфильтровываются, чтобы сохранить контекст суб-агента небольшим). Внутренние хуки могут перехватить этот шаг через agent:bootstrap, чтобы изменить или заменить внедряемые файлы начальной загрузки (например, заменив SOUL.md на альтернативную личность). Чтобы проверить, сколько вносит каждый внедренный файл (сырой vs внедренный, обрезка, плюс накладные расходы схемы инструментов), используйте /context list или /context detail. См. Контекст.

Обработка времени​

Системный промпт включает специальный раздел Текущая дата и время, когда часовой пояс пользователя известен. Чтобы промпт оставался стабильным для кэширования, теперь он включает только часовой пояс (без динамических часов или формата времени). Используйте session_status, когда агенту нужно текущее время; карточка статуса включает строку с меткой времени. Настройте с помощью:

  • agents.defaults.userTimezone
  • agents.defaults.timeFormat (auto | 12 | 24)

См. Дата и время для полного описания поведения.

Навыки​

Когда существуют подходящие навыки, OpenClaw внедряет компактный список доступных навыков (formatSkillsForPrompt), который включает путь к файлу для каждого навыка. Промпт инструктирует модель использовать read для загрузки файла SKILL.md по указанному местоположению (рабочее пространство, управляемые или встроенные навыки). Если нет подходящих навыков, раздел Навыки опускается.

<available_skills>
  <skill>
    <name>...</name>
    <description>...</description>
    <location>...</location>
  </skill>
</available_skills>

Это позволяет сохранить базовый промпт небольшим, обеспечивая при этом целенаправленное использование навыков.

Документация​

При наличии системный промпт включает раздел Документация, который указывает на локальную директорию документации OpenClaw (либо docs/ в рабочем пространстве репозитория, либо документация встроенного npm-пакета), а также отмечает публичное зеркало, исходный репозиторий, сообщество Discord и ClawHub (https://clawhub.com) для поиска навыков. Промпт инструктирует модель сначала обращаться к локальной документации для получения информации о поведении OpenClaw, командах, конфигурации или архитектуре, и по возможности запускать openclaw status самостоятельно (спрашивая пользователя только при отсутствии доступа).

Цикл агентаКонтекст