Skip to main content
Flusso di lavoro per sviluppatori per il runtime dell’agente (src/agents/) nel repository OpenClaw.

Controllo dei tipi e linting

  • Verifica locale predefinita: pnpm check (controllo dei tipi, linting, controlli delle policy)
  • Verifica della build: pnpm build quando la modifica può influire sull’output della build, sulla creazione dei pacchetti o sui confini del caricamento differito/dei moduli
  • Verifica pre-push completa: pnpm build && pnpm check && pnpm check:test-types && pnpm test

Esecuzione dei test del runtime dell’agente

Eseguire le suite di test unitari del runtime dell’agente:
Il primo glob include anche le suite agent-tools*, agent-settings e agent-tool-definition-adapter*. I test live sono esclusi dalla configurazione dei test unitari; eseguirli tramite il wrapper live (imposta OPENCLAW_LIVE_TEST=1 e richiede le credenziali del provider):

Test manuali

  • Eseguire il Gateway in modalità di sviluppo (ignora le connessioni ai canali tramite OPENCLAW_SKIP_CHANNELS=1): pnpm gateway:dev
  • Attivare un turno dell’agente tramite il Gateway: pnpm openclaw agent --message "Hello" --thinking low
  • Utilizzare la TUI per il debug interattivo: pnpm tui
Per il comportamento delle chiamate agli strumenti, richiedere un’azione read o exec per poter osservare lo streaming degli strumenti e la gestione del payload.

Ripristino completo

Lo stato risiede nella directory di stato di OpenClaw: ~/.openclaw per impostazione predefinita oppure $OPENCLAW_STATE_DIR, se impostata. Percorsi relativi a tale directory: Eliminare questi percorsi per un ripristino completo. Ripristini più circoscritti:
  • Solo sessioni: non eliminare agents/<agentId>/agent/openclaw-agent.sqlite; le righe delle sessioni risiedono al suo interno insieme agli altri stati per agente. Utilizzare /new o /reset per avviare una nuova sessione per una chat e openclaw sessions cleanup per la manutenzione delle sessioni.
  • Mantenere l’autenticazione: lasciare agents/<agentId>/agent/openclaw-agent.sqlite e credentials/ al loro posto.
I file legacy auth-profiles.json non vengono più letti durante l’esecuzione; openclaw doctor --fix li importa nell’archivio SQLite.

Riferimenti

Correlati