'OpenClaw Testing Guide: So testest du zuverlässig'

Kennst du das? Deine lokalen Tests laufen perfekt durch, aber sobald der Code in der Produktion landet, brechen die API-Verbindungen ab. Oder du hast Sorge, dass ein kleiner Fehler in der Test-Konfiguration dein Budget durch unkontrollierte Provider-Aufrufe sprengt.

Es ist frustrierend, wenn man nicht genau weiß, welcher Test nur die Logik prüft und welcher tatsächlich Geld kostet. OpenClaw nutzt deshalb ein System aus drei Stufen, damit du immer die volle Kontrolle über Kosten und Genauigkeit behältst.

Voraussetzungen

Bevor du startest, stelle sicher, dass du folgende Dinge bereit hast:

pnpm (Paketmanager)
API-Keys (nur für die Live-Suite erforderlich)
Docker (optional für die Linux-Validierung)
Zugriff auf die Konfigurationsdateien unter ~/.openclaw/

Schnellstart

Hier ist der schnellste Weg, um deinen Code zu validieren. Diese Befehle decken die minimale Pfadlänge ab:

# Kompletter Check (empfohlen vor jedem Push)
pnpm lint && pnpm build && pnpm test

# Tests mit Coverage-Bericht
pnpm test:coverage

# E2E-Suite (Gateway-Networking)
pnpm test:e2e

# Live-Suite (Echte Provider, echte Kosten)
pnpm test:live

Test Suites

OpenClaw unterteilt Tests in verschiedene Kategorien, je nachdem, was du gerade entwickelst.

1. Unit / Integration (Default)

Diese Tests laufen standardmäßig und sind für die tägliche Arbeit gedacht.

Befehl: pnpm test
Dateien: src/**/*.test.ts
Scope: Pure Unit-Tests, In-Process Integration, deterministische Regressionen.
Speed: Schnell ⚡

2. E2E (Gateway Smoke)

Nutze diese Suite, wenn du an der Infrastruktur arbeitest.

Befehl: pnpm test:e2e
Dateien: src/**/*.e2e.test.ts
Scope: Multi-Instance Gateway, WebSocket, HTTP-Schnittstellen, Node-Pairing.
CI: Läuft in der CI (wenn aktiviert).

3. Live (Real Providers)

Hier werden echte API-Aufrufe an Provider gesendet.

Befehl: pnpm test:live
Dateien: src/**/*.live.test.ts
Scope: Echte API-Calls, Kosten fallen an, Rate-Limits gelten.
Keys: API-Keys zwingend erforderlich.

4. Docker Runners

Validierung für Linux-Umgebungen innerhalb von Docker-Containern.

Befehle: pnpm test:docker:live-models oder pnpm test:docker:gateway-network.
Scope: Onboarding-Wizard, Plugin-Loading, Multi-Container Networking.

Live Testing im Detail

Live-Tests sind in zwei Layer unterteilt, damit du Fehler besser isolieren kannst.

Layer 1: Direct Model Completion

Testet Provider direkt ohne das Gateway. Das ist hilfreich, um zu prüfen, ob die API des Providers defekt ist oder dein eigener Code.

OPENCLAW_LIVE_MODELS="openai/gpt-5.2" pnpm test:live src/agents/models.profiles.live.test.ts

Layer 2: Gateway + Agent Smoke

Der komplette Prozess: Gateway → Agent → Model → Tools. Hierbei werden Probes wie Read-Checks, Exec-Checks und Image-OCR durchgeführt.

OPENCLAW_LIVE_GATEWAY_MODELS="openai/gpt-5.2" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts

Fehlerbehebung

Wenn etwas schiefgeht, hilft dir diese Übersicht, die richtige Suite zu finden:

Szenario	Suite
Du bearbeitest Logik oder Tests	`pnpm test`
Änderungen am Gateway-Networking	`pnpm test:e2e` hinzufügen
”Mein Bot ist down” / Provider-Probleme	Gezielter `pnpm test:live`
Fehler bei der Plugin-Ladung	`pnpm test:docker:plugins`

Credentials für Live-Tests

Die Live-Tests beziehen ihre Zugangsdaten genau wie das CLI aus diesen Quellen:

Profile Store: ~/.openclaw/credentials/
Konfiguration: ~/.openclaw/openclaw.json
Umgebungsvariablen

Falls du erzwingen möchtest, dass nur Keys aus deinem Profil genutzt werden, verwende:

OPENCLAW_LIVE_REQUIRE_PROFILE_KEYS=1 pnpm test:live

Empfohlene Live-Rezepte

Verwende Allowlists, um Kosten zu sparen und Flakiness zu vermeiden:

# Einzelnes Modell, direkt (ohne Gateway)
OPENCLAW_LIVE_MODELS="openai/gpt-5.2" pnpm test:live src/agents/models.profiles.live.test.ts

# Tool-Calling über mehrere Provider hinweg
OPENCLAW_LIVE_GATEWAY_MODELS="openai/gpt-5.2,anthropic/claude-opus-4-5,google/gemini-3-flash-preview,zai/glm-4.7,minimax/minimax-m2.1" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts

Du kannst jederzeit mit openclaw models list prüfen, welche Modelle aktuell verfügbar sind.

Hast du Probleme mit einem speziellen Test-Setup? Unser AI Setup Assistant hilft dir bei der Fehlersuche.

Nächste Schritte

Logging → — Log-Dateien und Konsolenausgaben verstehen
Debugging → — Watch-Mode und Raw-Streams nutzen
Contributing → — Richtlinien für die Entwicklung und Pull Requests

OpenClaw Expert

Noch festgefahren?

Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.