Technical reference

Ajan çalışma zamanı mimarisi

OpenClaw, yerleşik ajan çalışma zamanının sahibidir. Çalışma zamanı kodu src/agents/ altında, model/sağlayıcı aktarımı src/llm/ altında bulunur ve plugin'lere yönelik sözleşmeler openclaw/plugin-sdk/* barrel'ları üzerinden sunulur.

Çalışma Zamanı Düzeni

Yol	Sorumluluk
`src/agents/embedded-agent-runner/`	Yerleşik deneme döngüsü (`run.ts`, `run/`), model seçimi ve sağlayıcı normalizasyonu (`model.ts`), sağlayıcı başına istek parametreleri (`extra-params.`), Compaction, transkript ve oturum bağlantıları.
`src/agents/sessions/`	Oturum kalıcılığı (`session-manager.ts`), kaynak keşfi (`package-manager.ts`, `resource-loader.ts`), oturum içi `extensions` yükleme, istem şablonları, Skills, temalar ve TUI destekli araç işleyicileri (`tools/`).
`packages/agent-core/`	Yeniden kullanılabilir ajan çekirdeği (`@openclaw/agent-core`): ajan döngüsü, çalıştırma düzeneği türleri, iletiler, Compaction yardımcıları, istem şablonları, Skills ve oturum depolama sözleşmeleri.
`src/agents/runtime/`	`@openclaw/agent-core` ile plugin SDK LLM çalışma zamanını bağlayan ve bunu yerel proxy yardımcı programlarıyla birlikte yeniden dışa aktaran OpenClaw cephesi.
`src/agents/agent-tools*.ts`	OpenClaw'a ait araç tanımları, parametre şemaları, araç politikası, araç çağrısı öncesi/sonrası bağdaştırıcıları ve ana makine/sandbox düzenleme araçları.
`src/agents/agent-hooks/`	Yerleşik çalışma zamanı kancaları: Compaction koruması, Compaction talimatları, bağlam budama.
`src/agents/harness/`	Yerleşik ve plugin tarafından kaydedilen çalıştırma düzenekleri için çalıştırma düzeneği kayıt defteri, seçim politikası ve yaşam döngüsü.
`src/llm/`	Model/sağlayıcı kayıt defteri, aktarım yardımcıları ve sağlayıcıya özgü akış uygulamaları (`src/llm/providers/`).

Sınırlar

Çekirdek, yerleşik çalışma zamanını OpenClaw modülleri ve SDK barrel'ları üzerinden çağırır; harici ajan çerçevesi paketleri artık kullanılmaz. Plugin'ler belgelenmiş openclaw/plugin-sdk/* giriş noktalarını kullanır ve src/** iç bileşenlerini içe aktarmaz.

@earendil-works/pi-tui üçüncü taraf bağımlılığı olarak kalır: yerel TUI ve oturum aracı işleyicileri tarafından kullanılan bir terminal bileşeni araç takımıdır. Bunun içselleştirilmesi, ayrı bir kaynak kodu bünyeye alma çalışması gerektirir.

Manifestler

Kaynak paketleri, package.json meta verilerinde OpenClaw kaynaklarını bildirir. Girdiler, paket köküne göreli dosya yolları veya glob kalıplarıdır:

json

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

Bir manifestte listelenmeyen kaynak türleri için geleneksel extensions/, skills/, prompts/ ve themes/ dizinlerinin keşfine geri dönülür.

Çalışma Zamanı Seçimi

Yerleşik çalışma zamanı kimliği openclaw değeridir. Eski diğer ad pi, openclaw değerine; codex-app-server ise codex değerine normalleştirilir.
Plugin çalıştırma düzenekleri ek çalışma zamanı kimlikleri kaydeder (örneğin codex).
Çalışma zamanı politikası, model/sağlayıcı kapsamlı agentRuntime.id yapılandırmasıdır (model girdisi sağlayıcı girdisine göre önceliklidir). Ayarlanmamış değer veya default, auto olarak çözümlenir.
auto, etkin sağlayıcı yolunu destekleyen kayıtlı bir plugin çalıştırma düzeneğini, aksi durumda yerleşik OpenClaw çalışma zamanını seçer. Yalnızca sağlayıcı veya model öneki hiçbir zaman bir çalıştırma düzeneği seçmez.
OpenAI, yalnızca yazılmış bir istek geçersiz kılması bulunmayan, tam olarak eşleşen resmî bir HTTPS Platform Responses veya ChatGPT Responses yolu için codex değerini örtük olarak seçebilir. Completions bağdaştırıcıları, özel uç noktalar ve yazılmış istek davranışına sahip yollar openclaw üzerinde kalır; düz metin kullanan resmî HTTP uç noktaları reddedilir. Bkz. OpenAI örtük ajan çalışma zamanı.

Model Çalışma Zamanı Nesilleri

Gateway başlangıcı ile yapılandırma, plugin veya kimlik doğrulama yayını, yapılandırılmış her ajan için hazırlanmış bir model çalışma zamanı nesli oluşturur. Her nesil, keşfedilen kimlik doğrulama şablonunu, model kayıt defterini ve yansıtılmış model kataloğunu tek bir atomik anlık görüntü olarak içerir. Ajan çalıştırmaları, değiştirilebilir kimlik doğrulama ve kayıt defteri depolarını bu anlık görüntüden çatallar; göz atma, durum, Cron, doctor, TUI, PDF ve görüntü yolları, dosya sistemi keşfini tekrarlamak yerine yayımlanan kataloğu okur.

Bağımsız gömülü çalışma zamanları, etkinleştirme sınırlarında aynı anlık görüntü biçimini yayımlar. Başarısız veya eski bir nesil, daha yeni bir kısmi nesille birlikte hiçbir zaman sunulmaz; yaşam döngüsü sahibi önce eksiksiz bir yenisini yayımlamalıdır.

İlgili

Was this useful?