Advanced setup
OpenClaw ajan çalışma zamanı iş akışı
OpenClaw deposundaki ajan çalışma zamanı (src/agents/) için geliştirici iş akışı.
Tür denetimi ve lint
- Varsayılan yerel geçit:
pnpm check(tür denetimi, lint, ilke korumaları) - Derleme geçidi: Değişiklik derleme çıktısını, paketlemeyi veya gecikmeli yükleme/modül sınırlarını etkileyebiliyorsa
pnpm build - Gönderim öncesi tam geçit:
pnpm build && pnpm check && pnpm check:test-types && pnpm test
Ajan Çalışma Zamanı Testlerini Çalıştırma
Ajan çalışma zamanı birim test paketlerini çalıştırın:
pnpm test \ "src/agents/agent-*.test.ts" \ "src/agents/embedded-agent-*.test.ts" \ "src/agents/agent-hooks/**/*.test.ts"İlk glob ayrıca agent-tools*, agent-settings ve
agent-tool-definition-adapter* test paketlerini de kapsar.
Canlı testler birim test yapılandırmasının dışında tutulur; bunları canlı test
sarmalayıcısı üzerinden çalıştırın (OPENCLAW_LIVE_TEST=1 değerini ayarlar ve sağlayıcı kimlik bilgileri gerektirir):
pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.tsManuel test
- Gateway'i geliştirme modunda çalıştırın (
OPENCLAW_SKIP_CHANNELS=1aracılığıyla kanal bağlantılarını atlar):pnpm gateway:dev - Gateway üzerinden bir ajan turu tetikleyin:
pnpm openclaw agent --message "Hello" --thinking low - Etkileşimli hata ayıklama için TUI'yi kullanın:
pnpm tui
Araç çağrısı davranışını test etmek için araç akışını ve yük işleme sürecini izleyebilmek
amacıyla bir read veya exec eylemi isteyin.
Temiz başlangıç için sıfırlama
Durum, varsayılan olarak ~/.openclaw olan veya ayarlandığında
$OPENCLAW_STATE_DIR değerini kullanan OpenClaw durum dizininde bulunur. Bu dizine göre bağıl yollar:
| Yol | İçerik |
|---|---|
openclaw.json |
Yapılandırma |
state/openclaw.sqlite |
Paylaşılan çalışma zamanı durum veritabanı |
agents/<agentId>/agent/openclaw-agent.sqlite |
Ajan başına model kimlik doğrulama profilleri (API anahtarları + OAuth) ve çalışma zamanı durumu |
credentials/ |
Kimlik doğrulama profili deposunun dışındaki sağlayıcı/kanal kimlik bilgileri |
agents/<agentId>/sessions/ |
Transkript geçmişi ve eski oturum taşıma kaynakları |
sessions/ |
Eski tek ajanlı oturum deposu (yalnızca eski kurulumlar) |
workspace/ |
Varsayılan ajan çalışma alanı (ek ajanlar workspace-<agentId> kullanır) |
Tam sıfırlama için bu yolları silin. Daha dar kapsamlı sıfırlamalar:
- Yalnızca oturumlar:
agents/<agentId>/agent/openclaw-agent.sqliteöğesini silmeyin; oturum satırları, diğer ajan başına durum verileriyle birlikte burada bulunur. Tek bir sohbet için yeni bir oturum başlatmak üzere/newveya/reset, oturum bakımı içinseopenclaw sessions cleanupkullanın. - Kimlik doğrulamayı koruma:
agents/<agentId>/agent/openclaw-agent.sqlitevecredentials/öğelerini yerinde bırakın.
Eski auth-profiles.json dosyaları artık çalışma zamanında okunmaz;
openclaw doctor --fix bunları SQLite deposuna aktarır.
