Technical reference

Architektura środowiska uruchomieniowego agenta

OpenClaw jest właścicielem wbudowanego środowiska uruchomieniowego agenta. Kod środowiska uruchomieniowego znajduje się w src/agents/, transport modeli/dostawców znajduje się w src/llm/, a kontrakty przeznaczone dla pluginów są udostępniane przez moduły zbiorcze openclaw/plugin-sdk/*.

Układ środowiska uruchomieniowego

Ścieżka	Odpowiada za
`src/agents/embedded-agent-runner/`	Wbudowaną pętlę prób (`run.ts`, `run/`), wybór modelu i normalizację dostawcy (`model.ts`), parametry żądań dla poszczególnych dostawców (`extra-params.`), Compaction oraz integrację transkrypcji i sesji.
`src/agents/sessions/`	Trwałość sesji (`session-manager.ts`), wykrywanie zasobów (`package-manager.ts`, `resource-loader.ts`), ładowanie `extensions` w ramach sesji, szablony promptów, Skills, motywy oraz renderery narzędzi oparte na TUI (`tools/`).
`packages/agent-core/`	Rdzeń agenta wielokrotnego użytku (`@openclaw/agent-core`): pętlę agenta, typy infrastruktury wykonawczej, wiadomości, funkcje pomocnicze Compaction, szablony promptów, Skills oraz kontrakty przechowywania sesji.
`src/agents/runtime/`	Fasadę OpenClaw, która łączy `@openclaw/agent-core` ze środowiskiem uruchomieniowym LLM zestawu SDK pluginów oraz ponownie eksportuje je wraz z lokalnymi narzędziami serwera proxy.
`src/agents/agent-tools*.ts`	Definicje narzędzi należące do OpenClaw, schematy parametrów, zasady narzędzi, adaptery wywołań narzędzi przed wykonaniem i po nim oraz narzędzia edycji hosta/piaskownicy.
`src/agents/agent-hooks/`	Wbudowane punkty zaczepienia środowiska uruchomieniowego: zabezpieczenie Compaction, instrukcje Compaction, przycinanie kontekstu.
`src/agents/harness/`	Rejestr infrastruktury wykonawczej, zasady wyboru i cykl życia wbudowanych oraz zarejestrowanych przez pluginy infrastruktur wykonawczych.
`src/llm/`	Rejestr modeli/dostawców, funkcje pomocnicze transportu oraz implementacje strumieni specyficzne dla dostawców (`src/llm/providers/`).

Granice

Rdzeń wywołuje wbudowane środowisko uruchomieniowe za pośrednictwem modułów OpenClaw i modułów zbiorczych SDK; nie pozostały żadne zewnętrzne pakiety struktur programistycznych agentów. Pluginy używają udokumentowanych punktów wejścia openclaw/plugin-sdk/* i nie importują wewnętrznych elementów src/**.

@earendil-works/pi-tui pozostaje zależnością zewnętrzną: zestawem komponentów terminalowych używanym przez lokalne TUI i renderery narzędzi sesji. Włączenie go do projektu byłoby osobnym przedsięwzięciem związanym z kopiowaniem kodu zależności.

Manifesty

Pakiety zasobów deklarują zasoby OpenClaw w metadanych package.json. Wpisy są ścieżkami plików lub wzorcami glob względem katalogu głównego pakietu:

json

{  "openclaw": {    "extensions": ["extensions/index.ts"],    "skills": ["skills/*.md"],    "prompts": ["prompts/*.md"],    "themes": ["themes/*.json"]  }}

Typy zasobów niewymienione w manifeście korzystają awaryjnie z wykrywania standardowych katalogów extensions/, skills/, prompts/ i themes/.

Wybór środowiska uruchomieniowego

Identyfikator wbudowanego środowiska uruchomieniowego to openclaw. Starszy alias pi jest normalizowany do openclaw; codex-app-server jest normalizowany do codex.
Infrastruktury wykonawcze pluginów rejestrują dodatkowe identyfikatory środowisk uruchomieniowych (na przykład codex).
Zasady środowiska uruchomieniowego określa konfiguracja agentRuntime.id ograniczona do modelu/dostawcy (wpis modelu ma pierwszeństwo przed wpisem dostawcy). Wartość nieustawiona lub default jest rozstrzygana jako auto.
auto wybiera zarejestrowaną infrastrukturę wykonawczą pluginu, która obsługuje efektywną trasę dostawcy, a w przeciwnym razie wbudowane środowisko uruchomieniowe OpenClaw. Sam prefiks dostawcy lub modelu nigdy nie powoduje wyboru infrastruktury wykonawczej.
OpenAI może niejawnie wybrać codex wyłącznie dla dokładnie pasującej oficjalnej trasy HTTPS Platform Responses lub ChatGPT Responses, bez jawnego nadpisania żądania. Adaptery Completions, niestandardowe punkty końcowe i trasy z jawnym zachowaniem żądań pozostają w openclaw; oficjalne punkty końcowe korzystające z nieszyfrowanego protokołu HTTP są odrzucane. Zobacz niejawne środowisko uruchomieniowe agenta OpenAI.

Powiązane

Was this useful?