OpenClawDocs
En esta página

En esta página

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Technical reference

Flujo de trabajo del entorno de ejecución del agente de OpenClaw

Flujo de trabajo de desarrollo para el entorno de ejecución del agente (src/agents/) en el repositorio de OpenClaw.

Comprobación de tipos y linting

  • Comprobación local predeterminada: pnpm check (comprobación de tipos, linting, controles de políticas)
  • Comprobación de compilación: pnpm build cuando el cambio puede afectar al resultado de la compilación, el empaquetado o los límites de carga diferida/módulos
  • Comprobación completa previa al envío: pnpm build && pnpm check && pnpm check:test-types && pnpm test

Ejecución de pruebas del entorno de ejecución del agente

Ejecute los conjuntos de pruebas unitarias del entorno de ejecución del agente:

bash
pnpm test \  "src/agents/agent-*.test.ts" \  "src/agents/embedded-agent-*.test.ts" \  "src/agents/agent-hooks/**/*.test.ts"

El primer patrón glob también incluye los conjuntos agent-tools*, agent-settings y agent-tool-definition-adapter*.

Las pruebas en vivo están excluidas de la configuración de pruebas unitarias; ejecútelas mediante el envoltorio de pruebas en vivo (establece OPENCLAW_LIVE_TEST=1 y requiere credenciales del proveedor):

bash
pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.ts

Pruebas manuales

  • Ejecute el Gateway en modo de desarrollo (omite las conexiones de canales mediante OPENCLAW_SKIP_CHANNELS=1): pnpm gateway:dev
  • Active un turno del agente mediante el Gateway: pnpm openclaw agent --message "Hello" --thinking low
  • Use la TUI para la depuración interactiva: pnpm tui

Para comprobar el comportamiento de las llamadas a herramientas, solicite una acción read o exec para poder observar la transmisión de las herramientas y el procesamiento de la carga útil.

Restablecimiento desde cero

El estado se almacena en el directorio de estado de OpenClaw: ~/.openclaw de forma predeterminada, o $OPENCLAW_STATE_DIR cuando está definido. Rutas relativas a ese directorio:

Ruta Contenido
openclaw.json Configuración
state/openclaw.sqlite Base de datos de estado compartido del entorno de ejecución
agents/<agentId>/agent/openclaw-agent.sqlite Perfiles de autenticación de modelos por agente (claves de API + OAuth) y estado del entorno de ejecución
credentials/ Credenciales de proveedores/canales fuera del almacén de perfiles de autenticación
agents/<agentId>/sessions/ Historial de transcripciones y fuentes de migración de sesiones heredadas
sessions/ Almacén heredado de sesiones de un solo agente (solo instalaciones antiguas)
workspace/ Espacio de trabajo predeterminado del agente (los agentes adicionales usan workspace-<agentId>)

Elimine esas rutas para realizar un restablecimiento completo. Restablecimientos más específicos:

  • Solo sesiones: no elimine agents/<agentId>/agent/openclaw-agent.sqlite; las filas de las sesiones se almacenan allí junto con otros estados por agente. Use /new o /reset para iniciar una sesión nueva para un chat y openclaw sessions cleanup para el mantenimiento de las sesiones.
  • Conservar la autenticación: mantenga agents/<agentId>/agent/openclaw-agent.sqlite y credentials/ en su lugar.

Los archivos heredados auth-profiles.json ya no se leen durante la ejecución; openclaw doctor --fix los importa al almacén SQLite.

Referencias

Relacionado

Was this useful?