Depuracion

Esta pagina cubre las herramientas de depuracion para la salida en streaming, especialmente cuando un proveedor mezcla razonamiento en el texto normal.

Sobrecargas de depuracion en tiempo de ejecucion

Usa /debug en el chat para establecer sobrecargas de configuracion solo en tiempo de ejecucion (en memoria, no en disco). /debug esta deshabilitado por defecto; habilitalo con commands.debug: true. Esto es util cuando necesitas alternar configuraciones poco comunes sin editar openclaw.json.

Ejemplos:

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

/debug reset limpia todas las sobrecargas y vuelve a la configuracion en disco.

Modo watch del Gateway

Para iterar rapidamente, ejecuta el gateway bajo el vigilante de archivos:

pnpm gateway:watch

Esto corresponde a:

node --watch-path src --watch-path tsconfig.json --watch-path package.json --watch-preserve-output scripts/run-node.mjs gateway --force

Agrega cualquier flag del CLI del gateway despues de gateway:watch y se pasaran en cada reinicio.

Perfil dev + gateway dev (—dev)

Usa el perfil dev para aislar el estado y levantar un entorno seguro y desechable para depuracion. Hay dos flags --dev:

  • --dev global (perfil): aisla el estado bajo ~/.openclaw-dev y establece el puerto del gateway por defecto en 19001 (los puertos derivados se ajustan con el).
  • gateway --dev: le dice al Gateway que cree automaticamente una configuracion + workspace por defecto cuando faltan (y omite BOOTSTRAP.md).

Flujo recomendado (perfil dev + bootstrap dev):

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

Si aun no tienes una instalacion global, ejecuta el CLI via pnpm openclaw ....

Lo que esto hace:

  1. Aislamiento de perfil (--dev global)

    • OPENCLAW_PROFILE=dev
    • OPENCLAW_STATE_DIR=~/.openclaw-dev
    • OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json
    • OPENCLAW_GATEWAY_PORT=19001 (browser/canvas se ajustan en consecuencia)

  2. Bootstrap dev (gateway --dev)

    • Escribe una configuracion minima si falta (gateway.mode=local, bind en loopback).
    • Establece agent.workspace al workspace dev.
    • Establece agent.skipBootstrap=true (sin BOOTSTRAP.md).
    • Crea los archivos del workspace si faltan: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md.
    • Identidad por defecto: C3-PO (droide de protocolo).
    • Omite proveedores de canal en modo dev (OPENCLAW_SKIP_CHANNELS=1).

Flujo de reset (inicio limpio):

pnpm gateway:dev:reset

Nota: --dev es un flag de perfil global y algunos runners lo consumen. Si necesitas especificarlo explicitamente, usa la forma de variable de entorno:

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset elimina la configuracion, credenciales, sesiones y el workspace dev (usando trash, no rm), y luego recrea la configuracion dev por defecto.

Consejo: si un gateway no-dev ya esta ejecutandose (launchd/systemd), detenlo primero:

openclaw gateway stop

Registro de flujo sin procesar (OpenClaw)

OpenClaw puede registrar el flujo sin procesar del asistente antes de cualquier filtrado/formateo. Esta es la mejor forma de ver si el razonamiento llega como deltas de texto plano (o como bloques de pensamiento separados).

Habilitalo via CLI:

pnpm gateway:watch --raw-stream

Ruta opcional:

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

Variables de entorno equivalentes:

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

Archivo por defecto:

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

Registro de chunks sin procesar (pi-mono)

Para capturar los chunks sin procesar compatibles con OpenAI antes de que se analicen en bloques, pi-mono expone un logger separado:

PI_RAW_STREAM=1

Ruta opcional:

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

Archivo por defecto:

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

Nota: esto solo lo emiten los procesos que usan el proveedor openai-completions de pi-mono.

Notas de seguridad

  • Los registros de flujo sin procesar pueden incluir prompts completos, salidas de herramientas y datos de usuario.
  • Manten los registros en local y eliminalos despues de depurar.
  • Si compartes registros, elimina secretos e informacion personal primero.
arrow_back
Anterior
Environment
Siguiente
Testing
arrow_forward