Advanced setup
Flusso di lavoro del runtime dell’agente OpenClaw
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 buildquando 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:
pnpm test \ "src/agents/agent-*.test.ts" \ "src/agents/embedded-agent-*.test.ts" \ "src/agents/agent-hooks/**/*.test.ts"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):
pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.tsTest 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:
| Percorso | Contenuto |
|---|---|
openclaw.json |
Configurazione |
state/openclaw.sqlite |
Database dello stato condiviso del runtime |
agents/<agentId>/agent/openclaw-agent.sqlite |
Profili di autenticazione del modello per agente (chiavi API + OAuth) e stato del runtime |
credentials/ |
Credenziali di provider/canali esterne all'archivio dei profili di autenticazione |
agents/<agentId>/sessions/ |
Cronologia delle trascrizioni e origini per la migrazione delle sessioni legacy |
sessions/ |
Archivio legacy delle sessioni per agente singolo (solo vecchie installazioni) |
workspace/ |
Spazio di lavoro predefinito dell'agente (gli agenti aggiuntivi usano workspace-<agentId>) |
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/newo/resetper avviare una nuova sessione per una chat eopenclaw sessions cleanupper la manutenzione delle sessioni. - Mantenere l'autenticazione: lasciare
agents/<agentId>/agent/openclaw-agent.sqliteecredentials/al loro posto.
I file legacy auth-profiles.json non vengono più letti durante l'esecuzione;
openclaw doctor --fix li importa nell'archivio SQLite.
