Subagentes OpenClaw: Não Trate uma Resposta como Confirmação de Conclusão

O sessions_spawn do OpenClaw é não bloqueante. Ele retorna um runId e a sessão filha quando o trabalho é aceito, não quando está concluído. Isso significa que uma sessão de orquestração pai pode receber saída parcial, resumi-la e reportar sucesso enquanto um filho ainda está em execução, falhou ou se perdeu.

Aguarde a Conclusão com sessions_yield

O OpenClaw documenta sessions_yield como a maneira correta de aguardar eventos de conclusão. Em vez de contar respostas, o pai deve ceder e bloquear até que a sessão filha atinja um estado terminal.

Fluxos de Trabalho Duráveis com Task Flow

Para fluxos de trabalho duráveis, o Task Flow vincula o trabalho de várias etapas a registros individuais de tarefas em segundo plano. Isso fornece um registro persistente do estado de cada tarefa, tornando possível a reconciliação.

Reconcilie Cada Filho Antes do Sucesso

O autor recomenda reconciliar cada filho necessário antes de permitir que o pai termine. A reconciliação deve incluir:

• parent_run_id
• child_run_id
• terminal_state
• verification_receipt
• completion_blocker

Estado ausente ou contraditório deve produzir incomplete_reconciliation, não sucesso. Um filho falho, cancelado ou perdido pode justificar um resultado parcial ou bloqueado — mas somente com evidências.

Teste Seu Orquestrador

Teste sua configuração com três filhos inofensivos: um que tenha sucesso, um que retorne saída parcial e depois falhe, e um que permaneça pendente. O pai deve recusar sucesso até que cada filho tenha um estado terminal autoritativo e a verificação necessária seja concluída.

Se o seu orquestrador atual simplesmente conta respostas, está na hora de auditá-lo em relação a esses requisitos.