Optimiza tu flujo de trabajo en OpenClaw: Guía de desarrollo

¿Alguna vez has sentido que tu entorno de desarrollo se vuelve un caos después de probar varias integraciones? Mantener un flujo de trabajo limpio y predecible es vital para no perder tiempo depurando errores de configuración en lugar de escribir código real.

Esta guía resume un flujo de trabajo sensato para trabajar en la integración de Pi dentro de OpenClaw.

Verificación de tipos y Linting

• Verificación de tipos y build: pnpm build
• Lint: pnpm lint
• Verificación de formato: pnpm format
• Validación completa antes de hacer push: pnpm lint && pnpm build && pnpm test

Ejecución de pruebas de Pi

Ejecuta el conjunto de pruebas enfocado en Pi directamente con Vitest:

pnpm test -- \
  "src/agents/pi-*.test.ts" \
  "src/agents/pi-embedded-*.test.ts" \
  "src/agents/pi-tools*.test.ts" \
  "src/agents/pi-settings.test.ts" \
  "src/agents/pi-tool-definition-adapter*.test.ts" \
  "src/agents/pi-hooks/**/*.test.ts"

Para incluir el ejercicio con el proveedor en vivo:

OPENCLAW_LIVE_TEST=1 pnpm test -- src/agents/pi-embedded-runner-extraparams.live.test.ts

Esto cubre las principales suites de unidades de Pi:

• src/agents/pi-*.test.ts
• src/agents/pi-embedded-*.test.ts
• src/agents/pi-tools*.test.ts
• src/agents/pi-settings.test.ts
• src/agents/pi-tool-definition-adapter.test.ts
• src/agents/pi-hooks/*.test.ts

Pruebas manuales

Flujo recomendado:

• Ejecuta el Gateway en modo dev: 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 observar el streaming de herramientas y el manejo de payloads.

Reinicio completo del estado

El estado reside en el directorio de estado de OpenClaw. Por defecto es ~/.openclaw. Si OPENCLAW_STATE_DIR está configurado, usa ese directorio en su lugar.

Para reiniciar todo:

• openclaw.json para la configuración
• credentials/ para perfiles de autenticación y tokens
• agents/<agentId>/sessions/ para el historial de sesiones del agente
• agents/<agentId>/sessions.json para el índice de sesiones
• sessions/ si existen rutas antiguas
• workspace/ si quieres un espacio de trabajo en blanco

Si solo quieres reiniciar las sesiones, elimina agents/<agentId>/sessions/ y agents/<agentId>/sessions.json para ese agente. Mantén credentials/ si no quieres volver a autenticarte.

Referencias

• Testing
• Getting Started

Siguientes pasos

• Configuración de agentes
• Guía de CLI

AI Setup Assistant