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

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

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

Путь	Назначение
`src/agents/embedded-agent-runner/`	Встроенный цикл попыток (`run.ts`, `run/`), выбор модели и нормализация провайдера (`model.ts`), параметры запросов для каждого провайдера (`extra-params.`), Compaction, связывание транскрипта и сеанса.
`src/agents/sessions/`	Сохранение сеансов (`session-manager.ts`), обнаружение ресурсов (`package-manager.ts`, `resource-loader.ts`), загрузка `extensions` в рамках сеанса, шаблоны промптов, Skills, темы и средства визуализации инструментов на базе TUI (`tools/`).
`packages/agent-core/`	Многократно используемое ядро агента (`@openclaw/agent-core`): цикл агента, типы каркаса, сообщения, вспомогательные средства Compaction, шаблоны промптов, Skills и контракты хранения сеансов.
`src/agents/runtime/`	Фасад OpenClaw, который подключает `@openclaw/agent-core` к среде выполнения LLM из SDK плагинов и повторно экспортирует её вместе с локальными утилитами прокси.
`src/agents/agent-tools*.ts`	Определения инструментов, принадлежащие OpenClaw, схемы параметров, политика инструментов, адаптеры до и после вызова инструментов, а также инструменты редактирования хоста и песочницы.
`src/agents/agent-hooks/`	Встроенные хуки среды выполнения: защита Compaction, инструкции Compaction, сокращение контекста.
`src/agents/harness/`	Реестр каркасов, политика выбора и управление жизненным циклом встроенных и зарегистрированных плагинами каркасов.
`src/llm/`	Реестр моделей и провайдеров, вспомогательные средства транспорта и специфичные для провайдеров реализации потоковой передачи (`src/llm/providers/`).

Границы

Ядро вызывает встроенную среду выполнения через модули OpenClaw и баррели SDK; внешние пакеты фреймворков агентов больше не используются. Плагины используют документированные точки входа openclaw/plugin-sdk/* и не импортируют внутренние компоненты src/**. @earendil-works/pi-tui остаётся сторонней зависимостью: это набор терминальных компонентов, используемый локальным TUI и средствами визуализации инструментов сеанса. Его включение во внутренний код потребовало бы отдельной работы по вендорингу.

Манифесты

Пакеты ресурсов объявляют ресурсы OpenClaw в метаданных package.json. Записи представляют собой пути к файлам или шаблоны glob относительно корня пакета:

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

Для типов ресурсов, не перечисленных в манифесте, используется обнаружение стандартных каталогов extensions/, skills/, prompts/ и themes/.

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

Идентификатор встроенной среды выполнения — openclaw. Устаревший псевдоним pi нормализуется в openclaw; codex-app-server нормализуется в codex.
Каркасы плагинов регистрируют дополнительные идентификаторы сред выполнения (например, codex).
Политика среды выполнения задаётся конфигурацией agentRuntime.id в области модели или провайдера (запись модели имеет приоритет над записью провайдера). Неустановленное значение или default разрешается в auto.
auto выбирает зарегистрированный каркас плагина, поддерживающий действующий маршрут провайдера, а в противном случае — встроенную среду выполнения OpenClaw. Один лишь префикс провайдера или модели никогда не выбирает каркас.
OpenAI может неявно выбрать codex только для точного официального HTTPS-маршрута Platform Responses или ChatGPT Responses без явно заданного переопределения запроса. Адаптеры Completions, пользовательские конечные точки и маршруты с явно заданным поведением запроса остаются на openclaw; официальные конечные точки с незашифрованным HTTP отклоняются. См. Неявная среда выполнения агента OpenAI.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

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

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

Границы

Манифесты

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

Связанные материалы

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

​Границы

​Манифесты

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

​Связанные материалы

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

Границы

Манифесты

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

Связанные материалы