Depuración¶

Esta página cubre ayudas de depuración para la salida en streaming, especialmente cuando un proveedor mezcla razonamiento dentro del texto normal.

Anulaciones de depuración de tiempo¶

Use /debug en el chat para establecer anulaciones de configuración solo en tiempo de ejecución (memoria, no disco). /debug está deshabilitado de forma predeterminada; actívelo con commands.debug: true. Esto es útil cuando necesita alternar configuraciones poco comunes sin editar openclaw.json.

Ejemplos:

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

/debug reset borra todas las anulaciones y vuelve a la configuración en disco.

Modo de observación del Gateway¶

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

pnpm gateway:watch --force

Esto se asigna a:

tsx watch src/entry.ts gateway --force

Agregue cualquier bandera de la CLI del gateway después de gateway:watch y se pasarán en cada reinicio.

Perfil de desarrollo + gateway de desarrollo (--dev)¶

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

• Global --dev (perfil): aísla el estado bajo ~/.openclaw-dev y establece de forma predeterminada el puerto del gateway en 19001 (los puertos derivados se ajustan con él).
• gateway --dev: indica al Gateway que cree automáticamente una configuración predeterminada + espacio de trabajo cuando falten (y omite BOOTSTRAP.md).

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

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

Si aún no tiene una instalación global, ejecute la CLI mediante pnpm openclaw ....

Qué hace esto:

1. Aislamiento del perfil (global --dev) - OPENCLAW_PROFILE=dev - OPENCLAW_STATE_DIR=~/.openclaw-dev - OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json - OPENCLAW_GATEWAY_PORT=19001 (el navegador/canvas se ajusta en consecuencia)

2. Bootstrap de desarrollo (gateway --dev) - Escribe una configuración mínima si falta (gateway.mode=local, enlaza a loopback). - Establece agent.workspace al espacio de trabajo de desarrollo. - Establece agent.skipBootstrap=true (sin BOOTSTRAP.md). - Inicializa los archivos del espacio de trabajo si faltan: 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).

Flujo de restablecimiento (inicio limpio):

pnpm gateway:dev:reset

Nota: --dev es una bandera de perfil global y algunos ejecutores se la tragan. Si necesita especificarla explícitamente, use 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 hay un gateway que no es de desarrollo en ejecución (launchd/systemd), deténgalo primero:

openclaw gateway stop

Registro de flujos en bruto (OpenClaw)¶

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

Habilítelo mediante la CLI:

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

Anulación opcional de la ruta:

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

Variables de env equivalentes:

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

Archivo predeterminado:

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

Registro de fragmentos en bruto (pi-mono)¶

Para capturar fragmentos en bruto compatibles con OpenAI 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 flujos en bruto pueden incluir prompts completos, salida de herramientas y datos de usuario.
• Mantenga los registros locales y elimínelos después de depurar.
• Si comparte registros, elimine secretos y PII primero.