Débogage¶

Cette page couvre les aides au débogage pour la sortie en streaming, en particulier lorsqu’un fournisseur mélange le raisonnement dans le texte normal.

Surcharge de débogage d'exécution¶

Utilisez /debug dans le chat pour définir des remplacements de configuration uniquement à l’exécution (en mémoire, pas sur disque). /debug est désactivé par défaut ; activez-le avec commands.debug: true. C’est pratique lorsque vous devez basculer des paramètres obscurs sans modifier openclaw.json.

Exemples :

/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug unset messages.responsePrefix
/debug reset

/debug reset efface tous les remplacements et revient à la configuration sur disque.

Mode watch de la Gateway (passerelle)¶

Pour des itérations rapides, exécutez la gateway sous le surveillant de fichiers :

pnpm gateway:watch --force

Ceci correspond à :

tsx watch src/entry.ts gateway --force

Ajoutez tous les indicateurs CLI de la gateway après gateway:watch et ils seront transmis à chaque redémarrage.

Profil dev + gateway dev (--dev)¶

Utilisez le profil dev pour isoler l’état et lancer une configuration sûre et jetable pour le débogage. Il existe deux indicateurs --dev :

--dev global (profil) : isole l’état sous ~/.openclaw-dev et définit par défaut le port de la gateway à 19001 (les ports dérivés se décalent avec lui).
gateway --dev : indique à la Gateway de créer automatiquement une configuration + un espace de travail par défaut s’ils sont manquants (et d’ignorer BOOTSTRAP.md).

Flux recommandé (profil dev + bootstrap dev) :

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

Si vous n’avez pas encore d’installation globale, exécutez la CLI via pnpm openclaw ....

Ce que cela fait :

Isolation du profil (--dev global) - OPENCLAW_PROFILE=dev - OPENCLAW_STATE_DIR=~/.openclaw-dev - OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json - OPENCLAW_GATEWAY_PORT=19001 (le navigateur/canvas se décale en conséquence)
Bootstrap dev (gateway --dev) - Écrit une configuration minimale si elle est manquante (gateway.mode=local, liaison loopback). - Définit agent.workspace sur l’espace de travail dev. - Définit agent.skipBootstrap=true (pas de BOOTSTRAP.md). - Amorce les fichiers de l’espace de travail s’ils sont manquants : AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md. - Identité par défaut : C3‑PO (droïde protocolaire). - Ignore les fournisseurs de canaux en mode dev (OPENCLAW_SKIP_CHANNELS=1).

Flux de réinitialisation (nouveau départ) :

pnpm gateway:dev:reset

Remarque : --dev est un indicateur de profil global et est absorbé par certains runners. Si vous devez l’indiquer explicitement, utilisez la forme en variable d’environnement :

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset efface la configuration, les identifiants, les sessions et l’espace de travail dev (en utilisant trash, pas rm), puis recrée la configuration dev par défaut.

Astuce : si une gateway non dev est déjà en cours d’exécution (launchd/systemd), arrêtez-la d’abord :

openclaw gateway stop

Journalisation du flux brut (OpenClaw)¶

OpenClaw peut journaliser le flux brut de l’assistant avant tout filtrage/formatage. C’est la meilleure façon de voir si le raisonnement arrive sous forme de deltas de texte brut (ou sous forme de blocs de réflexion séparés).

Activez-le via la CLI :

pnpm gateway:watch --force --raw-stream

Remplacement de chemin optionnel :

pnpm gateway:watch --force --raw-stream --raw-stream-path ~/.openclaw/logs/raw-stream.jsonl

Variantes équivalentes env :

OPENCLAW_RAW_STREAM=1
OPENCLAW_RAW_STREAM_PATH=~/.openclaw/logs/raw-stream.jsonl

Fichier par défaut :

~/.openclaw/logs/raw-stream.jsonl

Journalisation des chunks bruts (pi-mono)¶

Pour capturer les chunks bruts compatibles OpenAI avant qu’ils ne soient analysés en blocs, pi-mono expose un journaliseur distinct :

PI_RAW_STREAM=1

Chemin optionnel :

PI_RAW_STREAM_PATH=~/.pi-mono/logs/raw-openai-completions.jsonl

Fichier par défaut :

~/.pi-mono/logs/raw-openai-completions.jsonl

Remarque : ceci n’est émis que par les processus utilisant le fournisseur openai-completions de pi-mono.

Notes de sécurité¶

Les journaux de flux bruts peuvent inclure des invites complètes, la sortie des outils et des données utilisateur.
Conservez les journaux en local et supprimez-les après le débogage.
Si vous partagez des journaux, expurgez d’abord les secrets et les PII.