OpenClaw Pi-Integration: Workflow und Tests optimieren

Kennst du das? Du arbeitest an einer neuen Integration und das lokale Setup fühlt sich einfach unhandlich an. Ein klarer Workflow hilft dir dabei, den Fokus zu behalten und Fehler bei der Entwicklung von Pi-Features frühzeitig zu finden.

Workflow für die Pi-Entwicklung

Dieser Guide fasst einen sinnvollen Workflow für die Arbeit an der Pi-Integration in OpenClaw zusammen.

Type Checking und Linting

• Type Check und Build: pnpm build
• Linting: pnpm lint
• Format Check: pnpm format
• Kompletter Check vor dem Push: pnpm lint && pnpm build && pnpm test

Pi-Tests ausführen

Führe die Pi-spezifischen Tests direkt mit Vitest aus:

pnpm test -- \
  "src/agents/pi-*.test.ts" \
  "src/agents/pi-embedded-*.test.ts" \
  "src/agents/pi-tools*.test.ts" \
  "src/agents/pi-settings.test.ts" \
  "src/agents/pi-tool-definition-adapter*.test.ts" \
  "src/agents/pi-hooks/**/*.test.ts"

Um den Live-Provider-Test einzubeziehen:

OPENCLAW_LIVE_TEST=1 pnpm test -- src/agents/pi-embedded-runner-extraparams.live.test.ts

Dies deckt die wichtigsten Pi-Unit-Suites ab:

• src/agents/pi-*.test.ts
• src/agents/pi-embedded-*.test.ts
• src/agents/pi-tools*.test.ts
• src/agents/pi-settings.test.ts
• src/agents/pi-tool-definition-adapter.test.ts
• src/agents/pi-hooks/*.test.ts

Manuelles Testen

Ich empfehle dir diesen Flow:

• Starte das Gateway im dev mode:
  • pnpm gateway:dev
• Triggere den Agenten direkt:
  • pnpm openclaw agent --message "Hello" --thinking low
• Nutze das TUI für interaktives Debugging:
  • pnpm tui

Wenn du das Verhalten von Tool-Calls prüfen willst, fordere eine read- oder exec-Aktion an. So kannst du das Tool-Streaming und das Handling der Payloads direkt beobachten.

Alles auf Null setzen (Reset)

Der State wird im OpenClaw-State-Verzeichnis gespeichert. Standardmäßig ist das ~/.openclaw. Falls OPENCLAW_STATE_DIR gesetzt ist, verwende stattdessen dieses Verzeichnis.

Um alles zurückzusetzen:

• openclaw.json für die Konfiguration
• credentials/ für Auth-Profile und Tokens
• agents/<agentId>/sessions/ für die Session-Historie des Agenten
• agents/<agentId>/sessions.json für den Session-Index
• sessions/ falls veraltete Pfade existieren
• workspace/ für einen komplett leeren Workspace

Wenn du nur die Sessions zurücksetzen willst, lösche agents/<agentId>/sessions/ und agents/<agentId>/sessions.json für diesen Agenten. Behalte den Ordner credentials/, wenn du dich nicht erneut authentifizieren möchtest.

Referenzen

• Testing
• Getting Started

Nächste Schritte

• Testing
• Getting Started

AI Setup Assistant