Depuración

Depuración

Esta página cubre los asistentes de depuración para la salida en flujo, especialmente cuando un proveedor mezcla el razonamiento en el texto normal.

Invalidaciones de depuración en tiempo de ejecución

Use /debug en el chat para establecer invalidaciones de configuración solo en tiempo de ejecución (memoria, no disco). /debug está deshabilitado por defecto; habilítelo con commands.debug: true. Esto es útil cuando necesita alternar configuraciones oscuras sin editar openclaw.json.

Ejemplos:

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

/debug reset borra todas las invalidaciones y retorna a la configuración en disco.

Modo observador de la puerta de enlace

Para una iteración rápida, ejecute la puerta de enlace bajo el observador de archivos:

pnpm gateway:watch --force

Esto corresponde a:

tsx watch src/entry.ts gateway --force

Añada cualquier bandera CLI de la puerta de enlace después de gateway:watch y se pasarán en cada reinicio.

Perfil de desarrollo + puerta de enlace de desarrollo (—dev)

Use el perfil de desarrollo para aislar el estado e iniciar una configuración segura y desechable para depuración. Hay dos banderas --dev:

• --dev Global (perfil): aisla el estado bajo ~/.openclaw-dev y establece el puerto de la puerta de enlace por defecto en 19001 (los puertos derivados se desplazan con él).
• gateway --dev: le indica a la puerta de enlace que cree automáticamente una configuración predeterminada + espacio de trabajo cuando falten (y omita BOOTSTRAP.md).

Flujo recomendado (perfil de desarrollo + arranque de desarrollo):

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

Si aún no tiene una instalación global, ejecute el CLI a través de 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 (el navegador/canvas se desplazan en consecuencia)

2. Arranque de desarrollo (gateway --dev)

   • Escribe una configuración mínima si falta (gateway.mode=local, bucle de enlace).
   • Establece agent.workspace al espacio de trabajo de desarrollo.
   • Establece agent.skipBootstrap=true (sin BOOTSTRAP.md).
   • Si faltan, inicializa los archivos del espacio de trabajo: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md.
   • Identidad predeterminada: C3‑PO (droide de protocolo).
   • Omite los proveedores de canal en modo de desarrollo (OPENCLAW_SKIP_CHANNELS=1).

Reiniciar el flujo (inicio limpio):

pnpm gateway:dev:reset

Nota: --dev es una marca de perfil global y es consumida por algunos ejecutores. Si necesitas especificarlo, usa la forma de variable de entorno:

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset borra la configuración, las credenciales, las sesiones y el espacio de trabajo de desarrollo (usando trash, no rm), y luego recrea la configuración de desarrollo predeterminada.

Consejo: si ya se está ejecutando una puerta de enlace que no es de desarrollo (launchd/systemd), deténla primero:

openclaw gateway stop

Registro de flujo sin procesar (OpenClaw)

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

Actívalo mediante la CLI:

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

Anulación de ruta opcional:

pnpm gateway:watch --force --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 predeterminado:

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

Registro de fragmentos sin procesar (pi-mono)

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

PI_RAW_STREAM=1

Ruta opcional:

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

Archivo predeterminado:

~/.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 mensajes completos, salida de herramientas y datos del usuario.
• Mantén los registros localmente y elimínalos después de la depuración.
• Si compartes registros, borra primero los secretos y la información personal.