Advanced setup
Workflow van de OpenClaw-agentruntime
Ontwikkelaarsworkflow voor de agentruntime (src/agents/) in de OpenClaw-repo.
Typecontrole en linting
- Standaard lokale controle:
pnpm check(typecontrole, linting, beleidscontroles) - Buildcontrole:
pnpm buildwanneer de wijziging invloed kan hebben op builduitvoer, packaging of grenzen voor lazy-loading/modules - Volledige controle vóór pushen:
pnpm build && pnpm check && pnpm check:test-types && pnpm test
Agentruntimetests uitvoeren
Voer de unit-testsuites voor de agentruntime uit:
pnpm test \ "src/agents/agent-*.test.ts" \ "src/agents/embedded-agent-*.test.ts" \ "src/agents/agent-hooks/**/*.test.ts"De eerste glob omvat ook de suites agent-tools*, agent-settings en
agent-tool-definition-adapter*.
Live tests zijn uitgesloten van de unitconfiguratie; voer ze uit via de live
wrapper (stelt OPENCLAW_LIVE_TEST=1 in en vereist providerreferenties):
pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.tsHandmatig testen
- Voer de Gateway uit in ontwikkelmodus (slaat kanaalverbindingen over via
OPENCLAW_SKIP_CHANNELS=1):pnpm gateway:dev - Activeer één agentbeurt via de Gateway:
pnpm openclaw agent --message "Hello" --thinking low - Gebruik de TUI voor interactieve foutopsporing:
pnpm tui
Vraag voor het gedrag van toolaanroepen om een actie met read of exec, zodat je
toolstreaming en payloadverwerking kunt observeren.
Volledige reset
De status bevindt zich in de OpenClaw-statusmap: standaard ~/.openclaw, of
$OPENCLAW_STATE_DIR wanneer dit is ingesteld. Paden relatief ten opzichte van die map:
| Pad | Bevat |
|---|---|
openclaw.json |
Configuratie |
state/openclaw.sqlite |
Gedeelde database voor runtimestatus |
agents/<agentId>/agent/openclaw-agent.sqlite |
Modelauthenticatieprofielen per agent (API-sleutels + OAuth) en runtimestatus |
credentials/ |
Provider-/kanaalreferenties buiten de opslag voor authenticatieprofielen |
agents/<agentId>/sessions/ |
Transcriptgeschiedenis en migratiebronnen voor verouderde sessies |
sessions/ |
Verouderde sessieopslag voor één agent (alleen oude installaties) |
workspace/ |
Standaardwerkruimte voor agents (extra agents gebruiken workspace-<agentId>) |
Verwijder deze paden voor een volledige reset. Gerichtere resets:
- Alleen sessies: verwijder
agents/<agentId>/agent/openclaw-agent.sqliteniet; sessierijen staan daar naast andere status per agent. Gebruik/newof/resetom voor één chat een nieuwe sessie te starten enopenclaw sessions cleanupvoor sessieonderhoud. - Authenticatie behouden: laat
agents/<agentId>/agent/openclaw-agent.sqliteencredentials/staan.
Verouderde auth-profiles.json-bestanden worden tijdens runtime niet meer gelezen;
openclaw doctor --fix importeert ze in de SQLite-opslag.
