Advanced setup
Workflow der OpenClaw-Agentenlaufzeit
Entwickler-Workflow für die Agent-Runtime (src/agents/) im OpenClaw-Repository.
Typprüfung und Linting
- Standardmäßige lokale Prüfung:
pnpm check(Typprüfung, Linting, Richtlinienprüfungen) - Build-Prüfung:
pnpm build, wenn sich die Änderung auf Build-Ausgaben, Paketierung oder Lazy-Loading-/Modulgrenzen auswirken kann - Vollständige Prüfung vor dem Push:
pnpm build && pnpm check && pnpm check:test-types && pnpm test
Agent-Runtime-Tests ausführen
Führen Sie die Unit-Test-Suites der Agent-Runtime aus:
pnpm test \ "src/agents/agent-*.test.ts" \ "src/agents/embedded-agent-*.test.ts" \ "src/agents/agent-hooks/**/*.test.ts"Das erste Glob-Muster deckt auch die Test-Suites agent-tools*, agent-settings und
agent-tool-definition-adapter* ab.
Live-Tests sind von der Unit-Test-Konfiguration ausgeschlossen. Führen Sie sie über den Live-
Wrapper aus (setzt OPENCLAW_LIVE_TEST=1 und erfordert Provider-Anmeldedaten):
pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.tsManuelle Tests
- Führen Sie das Gateway im Entwicklungsmodus aus (überspringt Channel-Verbindungen über
OPENCLAW_SKIP_CHANNELS=1):pnpm gateway:dev - Lösen Sie über das Gateway einen Agent-Durchlauf aus:
pnpm openclaw agent --message "Hello" --thinking low - Verwenden Sie die TUI für interaktives Debugging:
pnpm tui
Fordern Sie zum Testen des Tool-Aufrufverhaltens eine read- oder exec-Aktion an, damit Sie
das Tool-Streaming und die Verarbeitung der Nutzdaten beobachten können.
Vollständiges Zurücksetzen
Der Zustand befindet sich im OpenClaw-Zustandsverzeichnis: standardmäßig ~/.openclaw oder
$OPENCLAW_STATE_DIR, wenn diese Variable gesetzt ist. Pfade relativ zu diesem Verzeichnis:
| Pfad | Inhalt |
|---|---|
openclaw.json |
Konfiguration |
state/openclaw.sqlite |
Gemeinsame Runtime-Zustandsdatenbank |
agents/<agentId>/agent/openclaw-agent.sqlite |
Agentspezifische Modellauthentifizierungsprofile (API-Schlüssel + OAuth) und Runtime-Zustand |
credentials/ |
Provider-/Channel-Anmeldedaten außerhalb des Authentifizierungsprofilspeichers |
agents/<agentId>/sessions/ |
Transkriptverlauf und Migrationsquellen für veraltete Sitzungen |
sessions/ |
Veralteter Sitzungsspeicher für einen einzelnen Agent (nur alte Installationen) |
workspace/ |
Standardarbeitsbereich des Agents (zusätzliche Agents verwenden workspace-<agentId>) |
Löschen Sie diese Pfade für ein vollständiges Zurücksetzen. Selektivere Zurücksetzungen:
- Nur Sitzungen: Löschen Sie
agents/<agentId>/agent/openclaw-agent.sqlitenicht; Sitzungszeilen befinden sich dort zusammen mit anderem agentspezifischem Zustand. Verwenden Sie/newoder/reset, um eine neue Sitzung für einen Chat zu starten, undopenclaw sessions cleanupfür die Sitzungsverwaltung. - Authentifizierung beibehalten: Belassen Sie
agents/<agentId>/agent/openclaw-agent.sqliteundcredentials/an ihrem Platz.
Veraltete auth-profiles.json-Dateien werden zur Laufzeit nicht mehr gelesen;
openclaw doctor --fix importiert sie in den SQLite-Speicher.
