Débogage

Débogage

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

Remplacements de configuration de débogage à l’exécution

Utilisez /debug dans le chat pour définir des remplacements de configuration uniquement à l’exécution (en mémoire, pas sur le disque). /debug est désactivé par défaut ; activez-le avec commands.debug: true. C’est pratique lorsque vous devez activer/désactiver 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 retourne à la configuration sur le disque.

Mode watch du Gateway

Pour une itération rapide, exécutez la passerelle sous le surveillateur de fichiers :

pnpm gateway:watch

Cela correspond à :

node scripts/watch-node.mjs gateway --force

L’observateur redémarre sur les fichiers pertinents pour la build sous src/, les fichiers source d’extension, les métadonnées d’extension package.json et openclaw.plugin.json, tsconfig.json, package.json, et tsdown.config.ts. Les modifications des métadonnées d’extension redémarrent la gateway sans forcer une reconstruction tsdown ; les modifications de source et de configuration reconstruisent toujours dist d’abord.

Ajoutez tous les indicateurs CLI du 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 éphémère pour le débogage. Il y a deux indicateurs --dev :

• --dev global (profile) : isole l’état sous ~/.openclaw-dev et définit le port du gateway par défaut à 19001 (les ports dérivés changent avec lui).
• gateway --dev : demande au Gateway de créer automatiquement une config par défaut + un workspace en cas d’absence (et ignore BOOTSTRAP.md).

Flux recommandé (dev profile + dev bootstrap) :

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

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

Ce que cela fait :

1. Isolement 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 change en conséquence)

2. Dev bootstrap (gateway --dev)

   • Écrit une config minimale si elle est manquante (gateway.mode=local, bind loopback).
   • Définit agent.workspace sur le workspace de développement.
   • Définit agent.skipBootstrap=true (pas de BOOTSTRAP.md).
   • Génère les fichiers du workspace s’ils sont manquants : AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md.
   • Identité par défaut : C3‑PO (droïde de protocole).
   • Ignore les fournisseurs de channel 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 consommé par certains runners. Si vous devez l’écrire explicitement, utilisez le format de variable d’environnement :

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

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

Astuce : si une passerelle non-développement 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 ou formatage. C’est le meilleur moyen de voir si le raisonnement arrive sous forme de deltas de texte brut (ou sous forme de blocs de pensée séparés).

Activez-le via CLI :

pnpm gateway:watch --raw-stream

Surcharge de chemin optionnelle :

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

Variables d’environnement équivalentes :

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 séparé :

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 les données utilisateur.
• Gardez les journaux en local et supprimez-les après le débogage.
• Si vous partagez des journaux, nettoyez d’abord les secrets et les données personnelles.