Technical reference
Architektur der Agent-Laufzeitumgebung
OpenClaw besitzt die integrierte Agent-Runtime. Der Runtime-Code befindet sich unter src/agents/, der Modell-/Provider-Transport unter src/llm/, und Verträge für Plugins werden über openclaw/plugin-sdk/*-Barrels bereitgestellt.
Runtime-Struktur
| Pfad | Zuständig für |
|---|---|
src/agents/embedded-agent-runner/ |
Integrierte Versuchsschleife (run.ts, run/), Modellauswahl und Provider-Normalisierung (model*.ts), anfragespezifische Parameter je Provider (extra-params.*), Compaction sowie Verknüpfung von Transkript und Sitzung. |
src/agents/sessions/ |
Sitzungspersistenz (session-manager.ts), Ressourcenerkennung (package-manager.ts, resource-loader.ts), sitzungsinternes Laden von extensions, Prompt-Vorlagen, Skills, Themes und TUI-gestützte Tool-Renderer (tools/). |
packages/agent-core/ |
Wiederverwendbarer Agent-Kern (@openclaw/agent-core): Agent-Schleife, Harness-Typen, Nachrichten, Compaction-Hilfsfunktionen, Prompt-Vorlagen, Skills und Verträge für die Sitzungsspeicherung. |
src/agents/runtime/ |
OpenClaw-Fassade, die @openclaw/agent-core mit der LLM-Runtime des Plugin-SDK verbindet und diese zusammen mit lokalen Proxy-Hilfsfunktionen erneut exportiert. |
src/agents/agent-tools*.ts |
OpenClaw-eigene Tool-Definitionen, Parameterschemas, Tool-Richtlinien, Adapter vor und nach Tool-Aufrufen sowie Bearbeitungs-Tools für Host und Sandbox. |
src/agents/agent-hooks/ |
Integrierte Runtime-Hooks: Compaction-Schutzmechanismus, Compaction-Anweisungen, Kontextbereinigung. |
src/agents/harness/ |
Harness-Registry, Auswahlrichtlinie und Lebenszyklus für die integrierten und durch Plugins registrierten Harnesses. |
src/llm/ |
Modell-/Provider-Registry, Transport-Hilfsfunktionen und providerspezifische Stream-Implementierungen (src/llm/providers/). |
Grenzen
Der Kern ruft die integrierte Runtime über OpenClaw-Module und SDK-Barrels auf; es verbleiben keine externen Pakete für Agent-Frameworks. Plugins verwenden dokumentierte openclaw/plugin-sdk/*-Einstiegspunkte und importieren keine internen Bestandteile von src/**.
@earendil-works/pi-tui bleibt eine Drittanbieterabhängigkeit: ein Toolkit für Terminalkomponenten, das von der lokalen TUI und den Tool-Renderern für Sitzungen verwendet wird. Seine Internalisierung wäre ein separates Vendoring-Vorhaben.
Manifeste
Ressourcenpakete deklarieren OpenClaw-Ressourcen in den Metadaten von package.json. Einträge sind Dateipfade oder Globs relativ zum Paketstamm:
{ "openclaw": { "extensions": ["extensions/index.ts"], "skills": ["skills/*.md"], "prompts": ["prompts/*.md"], "themes": ["themes/*.json"] }}Ressourcentypen, die nicht in einem Manifest aufgeführt sind, greifen auf die Erkennung der konventionellen Verzeichnisse extensions/, skills/, prompts/ und themes/ zurück.
Runtime-Auswahl
- Die ID der integrierten Runtime ist
openclaw. Der veraltete Aliaspiwird zuopenclawnormalisiert;codex-app-serverwird zucodexnormalisiert. - Plugin-Harnesses registrieren zusätzliche Runtime-IDs (zum Beispiel
codex). - Die Runtime-Richtlinie ist eine modell-/providerspezifische
agentRuntime.id-Konfiguration (der Modelleintrag hat Vorrang vor dem Providereintrag). Nicht gesetzt oderdefaultwird zuautoaufgelöst. autowählt ein registriertes Plugin-Harness aus, das die effektive Provider-Route unterstützt, andernfalls die integrierte OpenClaw-Runtime. Ein Provider- oder Modellpräfix allein wählt niemals ein Harness aus.- OpenAI darf
codexnur implizit für eine exakt übereinstimmende offizielle HTTPS-Route für Platform Responses oder ChatGPT Responses ohne selbst definierte Anfrageüberschreibung auswählen. Completions-Adapter, benutzerdefinierte Endpunkte und Routen mit selbst definiertem Anfrageverhalten verbleiben aufopenclaw; offizielle Klartext-HTTP-Endpunkte werden abgelehnt. Siehe Implizite Agent-Runtime von OpenAI.
Generationen der Modell-Runtime
Beim Start des Gateway sowie bei der Veröffentlichung von Konfigurationen, Plugins oder Authentifizierungsdaten wird pro konfiguriertem Agent eine vorbereitete Modell-Runtime-Generation erstellt. Jede Generation besitzt die erkannte Authentifizierungsvorlage, die Modell-Registry und den projizierten Modellkatalog als einen atomaren Snapshot. Agent-Ausführungen erzeugen veränderliche Authentifizierungs- und Registry-Speicher aus diesem Snapshot; Pfade für Durchsuchen, Status, Cron, Doctor, TUI, PDF und Bilder lesen den veröffentlichten Katalog, statt die Dateisystemerkennung zu wiederholen.
Eigenständige eingebettete Runtimes veröffentlichen an ihrer Aktivierungsgrenze dieselbe Snapshot-Struktur. Eine fehlgeschlagene oder veraltete Generation wird niemals zusammen mit einer neueren Teilgeneration bereitgestellt; der für den Lebenszyklus zuständige Eigentümer muss zuerst einen vollständigen Ersatz veröffentlichen.
