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 у метаданих пакета:
{ "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.