Skip to main content
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:
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 benötigt Provider-Anmeldedaten):

Manuelle Tests

  • Führen Sie den Gateway im Entwicklungsmodus aus (überspringt Kanalverbindungen über OPENCLAW_SKIP_CHANNELS=1): pnpm gateway:dev
  • Lösen Sie über den 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 Aktion vom Typ read oder exec an, damit Sie Tool-Streaming und Payload-Verarbeitung beobachten können.

Zurücksetzen auf einen bereinigten Ausgangszustand

Der Zustand befindet sich im OpenClaw-Zustandsverzeichnis: standardmäßig ~/.openclaw oder $OPENCLAW_STATE_DIR, wenn diese Variable gesetzt ist. Pfade relativ zu diesem Verzeichnis: Löschen Sie diese Pfade für ein vollständiges Zurücksetzen. Gezieltere Zurücksetzungen:
  • Nur Sitzungen: Löschen Sie agents/<agentId>/agent/openclaw-agent.sqlite nicht; Sitzungszeilen befinden sich dort zusammen mit anderem agentenspezifischem Zustand. Verwenden Sie /new oder /reset, um für einen Chat eine neue Sitzung zu starten, und openclaw sessions cleanup für die Sitzungsverwaltung.
  • Authentifizierung beibehalten: Belassen Sie agents/<agentId>/agent/openclaw-agent.sqlite und credentials/ unverändert.
Ältere auth-profiles.json-Dateien werden zur Laufzeit nicht mehr gelesen; openclaw doctor --fix importiert sie in den SQLite-Speicher.

Referenzen

Verwandte Themen