---
summary: Як OpenClaw запускає вбудоване середовище виконання агента, провайдерів, сеанси, інструменти та розширення.
title: Архітектура середовища виконання агента
x-i18n:
    generated_at: "2026-06-27T17:08:45Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: cd0ca61b10a4f7029590da8566b22cc44cf801af162e5f2c00c9561fe46e39e3
    source_path: agent-runtime-architecture.md
    workflow: 16
---

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

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

- `src/agents/embedded-agent-runner/`: вбудований цикл спроб агента, адаптери потоків постачальників, Compaction, вибір моделі та зв’язування сеансів.
- `src/agents/sessions/`: збереження сеансів, завантаження розширень, виявлення ресурсів, Skills, підказки, теми та рендерери інструментів на основі TUI.
- `packages/agent-core/`: повторно використовуване ядро агента, нижчорівневі типи harness, повідомлення, допоміжні засоби 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 harnesses можуть реєструвати додаткові ідентифікатори середовищ виконання. `auto` вибирає підтримуваний Plugin harness, якщо він існує, а інакше використовує вбудоване середовище виконання OpenClaw.

## Пов’язане

- [Робочий процес середовища виконання агента OpenClaw](/uk/openclaw-agent-runtime)
- [Середовища виконання агентів](/uk/concepts/agent-runtimes)