Skip to main content
OpenClaw memiliki runtime agen bawaan. Kode runtime berada di bawah src/agents/, transport model/penyedia berada di bawah src/llm/, dan kontrak untuk plugin diekspos melalui barrel openclaw/plugin-sdk/*.

​
Tata Letak Runtime

​
Batasan

Inti memanggil runtime bawaan melalui modul OpenClaw dan barrel SDK; tidak ada lagi paket kerangka kerja agen eksternal. Plugin menggunakan titik masuk openclaw/plugin-sdk/* yang terdokumentasi dan tidak mengimpor internal src/**. @earendil-works/pi-tui tetap menjadi dependensi pihak ketiga: toolkit komponen terminal yang digunakan oleh TUI lokal dan perender alat sesi. Menginternalisasikannya akan menjadi upaya vendoring terpisah.

​
Manifes

Paket sumber daya mendeklarasikan sumber daya OpenClaw dalam metadata package.json. Entri berupa jalur file atau glob yang relatif terhadap akar paket:
Jenis sumber daya yang tidak tercantum dalam manifes menggunakan penemuan direktori konvensional extensions/, skills/, prompts/, dan themes/ sebagai mekanisme cadangan.

​
Pemilihan Runtime

  • ID runtime bawaan adalah openclaw. Alias lama pi dinormalisasi menjadi openclaw; codex-app-server dinormalisasi menjadi codex.
  • Harness plugin mendaftarkan ID runtime tambahan (misalnya codex).
  • Kebijakan runtime adalah konfigurasi agentRuntime.id yang dicakup per model/penyedia (entri model mengungguli entri penyedia). Nilai yang tidak ditetapkan atau default diresolusikan menjadi auto.
  • auto memilih harness plugin terdaftar yang mendukung rute penyedia efektif; jika tidak, runtime bawaan OpenClaw digunakan. Awalan penyedia atau model saja tidak pernah memilih harness.
  • OpenAI dapat memilih codex secara implisit hanya untuk rute HTTPS resmi Platform Responses atau ChatGPT Responses yang persis cocok tanpa penggantian permintaan yang dibuat secara eksplisit. Adaptor Completions, endpoint khusus, dan rute dengan perilaku permintaan yang dibuat secara eksplisit tetap menggunakan openclaw; endpoint HTTP teks biasa resmi ditolak. Lihat runtime agen implisit OpenAI.

​
Generasi Runtime Model

Saat Gateway dimulai, konfigurasi, plugin, atau publikasi autentikasi membangun satu generasi runtime model yang telah disiapkan untuk setiap agen yang dikonfigurasi. Setiap generasi memiliki templat autentikasi yang ditemukan, registri model, dan katalog model yang diproyeksikan sebagai satu snapshot atomik. Proses agen membuat turunan penyimpanan autentikasi dan registri yang dapat diubah dari snapshot tersebut; jalur penelusuran, status, cron, doctor, TUI, PDF, dan gambar membaca katalog yang dipublikasikan alih-alih mengulangi penemuan sistem file. Runtime tertanam mandiri memublikasikan bentuk snapshot yang sama pada batas aktivasinya. Generasi yang gagal atau kedaluwarsa tidak pernah disajikan bersamaan dengan generasi parsial yang lebih baru; pemilik siklus hidup harus terlebih dahulu memublikasikan pengganti yang lengkap.

​
Terkait