Débogage

Débogage

Cette page couvre les aides au débogage pour la sortie en flux continu (streaming), 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 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 retourne à la configuration sur disque.

Mode watch du Gateway

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

pnpm gateway:watch --force

Cela correspond à :

tsx watch src/entry.ts gateway --force

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

Profil de développement + passerelle de développement (—dev)

Utilisez le profil de développement 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 (profil) : isole l’état sous ~/.openclaw-dev et définit le port de la passerelle par défaut à 19001 (les ports dérivés se décalent avec lui).
• gateway --dev : indique au Gateway de créer automatiquement une configuration par défaut + un espace de travail s’ils sont manquants (et ignore BOOTSTRAP.md).

Flux recommandé (profil dev + amorçage dev) :

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. 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)

2. Amorçage dev (gateway --dev)

   • Writes a minimal config if missing (gateway.mode=local, bind loopback).
   • Sets agent.workspace to the dev workspace.
   • Sets agent.skipBootstrap=true (no BOOTSTRAP.md).
   • Seeds the workspace files if missing: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md.
   • Default identity: C3‑PO (protocol droid).
   • Skips channel providers in dev mode (OPENCLAW_SKIP_CHANNELS=1).

Reset flow (fresh start):

pnpm gateway:dev:reset

Note: --dev is a global profile flag and gets eaten by some runners. If you need to spell it out, use the env var form:

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset wipes config, credentials, sessions, and the dev workspace (using trash, not rm), then recreates the default dev setup.

Tip: if a non‑dev gateway is already running (launchd/systemd), stop it first:

openclaw gateway stop

Raw stream logging (OpenClaw)

OpenClaw can log the raw assistant stream before any filtering/formatting. This is the best way to see whether reasoning is arriving as plain text deltas (or as separate thinking blocks).

Enable it via CLI:

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

Optional path override:

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

Equivalent env vars:

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

Default file:

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

Raw chunk logging (pi-mono)

To capture raw OpenAI-compat chunks before they are parsed into blocks, pi-mono exposes a separate logger:

PI_RAW_STREAM=1

Optional path:

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

Default file:

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

Note: this is only emitted by processes using pi-mono’s openai-completions provider.

Safety notes

• Raw stream logs can include full prompts, tool output, and user data.
• Keep logs local and delete them after debugging.
• If you share logs, scrub secrets and PII first.