> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Flujo de trabajo del runtime del agente de OpenClaw

Un flujo de trabajo sensato para trabajar en el tiempo de ejecución del agente de OpenClaw en OpenClaw.

## Comprobación de tipos y linting

* Compuerta local predeterminada: `pnpm check`
* Compuerta de compilación: `pnpm build` cuando el cambio pueda afectar la salida de compilación, el empaquetado o los límites de carga diferida/módulos
* Compuerta completa para integrar cambios del tiempo de ejecución del agente: `pnpm check && pnpm test`

## Ejecutar pruebas del tiempo de ejecución del agente

Ejecuta directamente el conjunto de pruebas del tiempo de ejecución del agente con Vitest:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test \
  "src/agents/agent-*.test.ts" \
  "src/agents/embedded-agent-*.test.ts" \
  "src/agents/agent-tools*.test.ts" \
  "src/agents/agent-settings.test.ts" \
  "src/agents/agent-tool-definition-adapter*.test.ts" \
  "src/agents/agent-hooks/**/*.test.ts"
```

Para incluir el ejercicio con proveedor en vivo:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_LIVE_TEST=1 pnpm test src/agents/embedded-agent-runner-extraparams.live.test.ts
```

Esto cubre los principales conjuntos de pruebas unitarias del tiempo de ejecución del agente:

* `src/agents/agent-*.test.ts`
* `src/agents/embedded-agent-*.test.ts`
* `src/agents/agent-tools*.test.ts`
* `src/agents/agent-settings.test.ts`
* `src/agents/agent-tool-definition-adapter.test.ts`
* `src/agents/agent-hooks/*.test.ts`

## Pruebas manuales

Flujo recomendado:

* Ejecuta el Gateway en modo de desarrollo:
  * `pnpm gateway:dev`
* Activa el agente directamente:
  * `pnpm openclaw agent --message "Hello" --thinking low`
* Usa la TUI para depuración interactiva:
  * `pnpm tui`

Para el comportamiento de llamadas a herramientas, solicita una acción `read` o `exec` para que puedas ver la transmisión de herramientas y el manejo de la carga útil.

## Restablecimiento desde cero

El estado reside en el directorio de estado de OpenClaw. El valor predeterminado es `~/.openclaw`. Si `OPENCLAW_STATE_DIR` está definido, usa ese directorio en su lugar.

Para restablecer todo:

* `openclaw.json` para la configuración
* `agents/<agentId>/agent/auth-profiles.json` para perfiles de autenticación de modelos (claves de API + OAuth)
* `credentials/` para el estado de proveedores/canales que aún reside fuera del almacén de perfiles de autenticación
* `agents/<agentId>/sessions/` para el historial de sesiones del agente
* `agents/<agentId>/sessions/sessions.json` para el índice de sesiones
* `sessions/` si existen rutas heredadas
* `workspace/` si quieres un espacio de trabajo en blanco

Si solo quieres restablecer las sesiones, elimina `agents/<agentId>/sessions/` para ese agente. Si quieres conservar la autenticación, deja `agents/<agentId>/agent/auth-profiles.json` y cualquier estado de proveedor en `credentials/` en su lugar.

## Referencias

* [Pruebas](/es/help/testing)
* [Primeros pasos](/es/start/getting-started)

## Relacionado

* [Arquitectura del tiempo de ejecución del agente de OpenClaw](/es/agent-runtime-architecture)