Архітектура середовища виконання агента

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` у межах сеансу, шаблони запитів, навички, теми та засоби візуалізації інструментів на основі TUI (`tools/`).
`packages/agent-core/`	Багаторазово використовуване ядро агента (`@openclaw/agent-core`): цикл агента, типи середовища, повідомлення, допоміжні засоби Compaction, шаблони запитів, навички та контракти сховища сеансів.
`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. Записи є шляхами до файлів або шаблонами пошуку відносно кореня пакета:

{
  "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

Архітектура середовища виконання агента

Структура середовища виконання

Межі

Маніфести

Вибір середовища виконання

Пов’язані матеріали

​Структура середовища виконання

​Межі

​Маніфести

​Вибір середовища виконання

​Пов’язані матеріали

Структура середовища виконання

Межі

Маніфести

Вибір середовища виконання

Пов’язані матеріали