Technical reference

Архитектура среды выполнения агента

OpenClaw напрямую владеет встроенной средой выполнения агента. Код среды выполнения находится в src/agents/, помощники для моделей/провайдеров находятся в src/llm/, а контракты для Plugin доступны через barrel-файлы openclaw/plugin-sdk/*.

Структура среды выполнения

src/agents/embedded-agent-runner/: встроенный цикл попыток агента, адаптеры потоков провайдеров, Compaction, выбор модели и связка сессий.
src/agents/sessions/: сохранение сессий, загрузка расширений, обнаружение ресурсов, Skills, промпты, темы и средства рендеринга инструментов на базе TUI.
packages/agent-core/: переиспользуемое ядро агента, низкоуровневые типы обвязки, сообщения, помощники Compaction, шаблоны промптов и контракты инструментов/сессий.
src/agents/runtime/: фасад OpenClaw для @openclaw/agent-core плюс локальные прокси-утилиты.
src/agents/agent-tools*.ts: принадлежащие OpenClaw определения инструментов, схемы, политика, адаптеры хуков до/после выполнения и поддержка правок на хосте.
src/agents/agent-hooks/: встроенные хуки среды выполнения, такие как защитные механизмы Compaction и сокращение контекста.
src/llm/: реестр моделей/провайдеров, транспортные помощники и реализации потоков, специфичные для провайдеров.

Границы

Код ядра вызывает встроенную среду выполнения через модули OpenClaw и barrel-файлы SDK, а не через старые внешние пакеты агентов. Plugins используют документированные точки входа openclaw/plugin-sdk/* и не импортируют внутренние модули src/**.

@earendil-works/pi-tui остается сторонней зависимостью TUI. Она используется локальным TUI и средствами рендеринга сессий как набор терминальных компонентов; ее внутреннее включение было бы отдельной работой по вендорингу.

Манифесты

Пакеты ресурсов объявляют ресурсы OpenClaw в метаданных пакета:

json

{  "openclaw": {    "extensions": ["extensions/index.ts"],    "skills": ["skills/*.md"],    "prompts": ["prompts/*.md"],    "themes": ["themes/*.json"]  }}

Менеджер пакетов также обнаруживает стандартные каталоги extensions/, skills/, prompts/ и themes/.

Выбор среды выполнения

Идентификатор встроенной среды выполнения по умолчанию — openclaw. Обвязки Plugin могут регистрировать дополнительные идентификаторы сред выполнения. auto выбирает поддерживающую обвязку Plugin, если она существует, а иначе использует встроенную среду выполнения OpenClaw.

Связанное

Was this useful?