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/: повторно використовуване ядро агента, нижчорівневі типи 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.

Пов’язане

Was this useful?
On this page

On this page