Среда выполнения агента 🤖

OpenClaw запускает одну встроенную среду выполнения агента, производную от p-mono.

Рабочее пространство (обязательно)

OpenClaw использует одну директорию рабочего пространства агента (agents.defaults.workspace) как единственную рабочую директорию агента (cwd) для инструментов и контекста.

Рекомендуется: используйте openclaw setup для создания ~/.openclaw/openclaw.json, если отсутствует, и инициализации файлов рабочего пространства.

Полная структура рабочего пространства + руководство по резервному копированию: Рабочее пространство агента

Если включен agents.defaults.sandbox, не-основные сессии могут переопределить это с помощью рабочих пространств для каждой сессии в agents.defaults.sandbox.workspaceRoot (см. Конфигурация Gateway).

Файлы Bootstrap (внедряемые)

Внутри agents.defaults.workspace OpenClaw ожидает эти редактируемые пользователем файлы:

  • AGENTS.md — операционные инструкции + "память"
  • SOUL.md — персона, границы, тон
  • TOOLS.md — пользовательские заметки об инструментах (например, imsg, sag, соглашения)
  • BOOTSTRAP.md — одноразовый ритуал первого запуска (удаляется после завершения)
  • IDENTITY.md — имя агента/стиль/эмодзи
  • USER.md — профиль пользователя + предпочтительное обращение

На первом ходу новой сессии OpenClaw внедряет содержимое этих файлов напрямую в контекст агента.

Пустые файлы пропускаются. Большие файлы обрезаются и усекаются с маркером, чтобы промпты оставались компактными (прочитайте файл для полного содержимого).

Если файл отсутствует, OpenClaw внедряет одну строку маркера "отсутствующий файл" (и openclaw setup создаст безопасный шаблон по умолчанию).

BOOTSTRAP.md создается только для совершенно нового рабочего пространства (нет других файлов bootstrap). Если вы удалите его после завершения ритуала, он не должен быть пересоздан при последующих перезапусках.

Для полного отключения создания файлов bootstrap (для предварительно заполненных рабочих пространств) установите:

{ agent: { skipBootstrap: true } }

Встроенные инструменты

Основные инструменты (read/exec/edit/write и связанные системные инструменты) всегда доступны, с учетом политики инструментов. apply_patch опционален и управляется tools.exec.applyPatch. TOOLS.md не контролирует, какие инструменты существуют; это руководство по тому, как вы хотите их использовать.

Навыки

OpenClaw загружает навыки из трех мест (рабочее пространство побеждает при конфликте имен):

  • Встроенные (поставляются с установкой)
  • Управляемые/локальные: ~/.openclaw/skills
  • Рабочее пространство: <workspace>/skills

Навыки могут быть ограничены конфигурацией/env (см. skills в Конфигурация Gateway).

Интеграция p-mono

OpenClaw переиспользует части кодовой базы p-mono (модели/инструменты), но управление сессиями, обнаружение и связывание инструментов принадлежат OpenClaw.

  • Нет среды выполнения агента p-coding.
  • Никакие настройки ~/.pi/agent или <workspace>/.pi не консультируются.

Сессии

Транскрипты сессий хранятся как JSONL по адресу:

  • ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl

ID сессии стабилен и выбирается OpenClaw. Папки легаси-сессий Pi/Tau не читаются.

Управление во время потоковой передачи

Когда режим очереди steer, входящие сообщения внедряются в текущий запуск. Очередь проверяется после каждого вызова инструмента; если присутствует сообщение в очереди, оставшиеся вызовы инструментов из текущего сообщения assistant пропускаются (результаты инструментов с ошибками "Skipped due to queued user message."), затем сообщение пользователя из очереди внедряется перед следующим ответом assistant.

Когда режим очереди followup или collect, входящие сообщения удерживаются до завершения текущего хода, затем новый ход агента начинается с пейлоадов из очереди. См. Очередь для режима + поведения debounce/cap.

Потоковая передача блоков отправляет завершенные блоки assistant сразу после их завершения; по умолчанию выключена (agents.defaults.blockStreamingDefault: "off"). Настройте границу через agents.defaults.blockStreamingBreak (text_end vs message_end; по умолчанию text_end). Контролируйте мягкий чанкинг блоков с agents.defaults.blockStreamingChunk (по умолчанию 800–1200 символов; предпочитает разрывы абзацев, затем новые строки; предложения последние). Объединяйте потоковые чанки с agents.defaults.blockStreamingCoalesce для уменьшения спама одиночных строк (слияние на основе простоя перед отправкой). Не-Telegram каналы требуют явного *.blockStreaming: true для включения блочных ответов. Подробные сводки инструментов генерируются при запуске инструмента (без debounce); Control UI передает вывод инструмента через события агента, когда доступно. Больше деталей: Потоковая передача + чанкинг.

Ссылки на модели

Ссылки на модели в конфигурации (например, agents.defaults.model и agents.defaults.models) парсятся разделением по первому /.

  • Используйте provider/model при конфигурировании моделей.
  • Если сам ID модели содержит / (стиль OpenRouter), включите префикс провайдера (пример: openrouter/moonshotai/kimi-k2).
  • Если вы опускаете провайдера, OpenClaw обрабатывает ввод как алиас или модель для провайдера по умолчанию (работает только когда нет / в ID модели).

Конфигурация (минимальная)

Как минимум, установите:

  • agents.defaults.workspace
  • channels.whatsapp.allowFrom (настоятельно рекомендуется)

Далее: Групповые чаты 🦞

← Назад к документации