Subagentes de OpenClaw: No trates una respuesta como un recibo de finalización

El sessions_spawn de OpenClaw no es bloqueante. Devuelve un runId y una sesión hija cuando el trabajo es aceptado, no cuando está completo. Esto significa que una sesión de orquestación padre puede recibir salida parcial, resumirla y reportar éxito mientras un hijo aún se está ejecutando, falló o se perdió.

Esperar la finalización con sessions_yield

OpenClaw documenta que sessions_yield es la forma correcta de esperar eventos de finalización. En lugar de contar respuestas, el padre debe ceder y bloquearse hasta que la sesión hija alcance un estado terminal.

Flujos de trabajo duraderos con Task Flow

Para flujos de trabajo duraderos, Task Flow vincula el trabajo de varios pasos con registros individuales de tareas en segundo plano. Esto le brinda un registro persistente del estado de cada tarea, lo que hace posible la reconciliación.

Reconciliar cada hijo antes de reportar éxito

El autor recomienda reconciliar cada hijo requerido antes de permitir que el padre termine. La reconciliación debe incluir:

• parent_run_id
• child_run_id
• terminal_state
• verification_receipt
• completion_blocker

La falta o contradicción en el estado debe producir incomplete_reconciliation, no éxito. Un hijo fallido, cancelado o perdido puede justificar un resultado parcial o bloqueado, pero solo con evidencia.

Pruebe su orquestador

Pruebe su configuración con tres hijos inofensivos: uno que tenga éxito, uno que devuelva salida parcial y luego falle, y uno que permanezca pendiente. El padre debe rechazar el éxito hasta que cada hijo tenga un estado terminal autoritativo y la verificación requerida esté completa.

Si su orquestador actual simplemente cuenta respuestas, es hora de auditarlo según estos requisitos.