Subagentes e múltiplos agentes no OpenClaw

O OpenClaw tem duas respostas para a questão de ter mais de um agente, e a documentação as mantém separadas. Subagentes são execuções em segundo plano iniciadas a partir de uma execução existente, cada uma na própria sessão, que anunciam o resultado a quem pediu e são acompanhadas como tarefas em segundo plano; múltiplos agentes são agentes configurados separadamente, com os próprios espaços de trabalho e o próprio roteamento. Veja o que é um subagente e quanto ele custa, até onde vai o aninhamento e como os resultados voltam, as ferramentas que um filho nunca pode ter e onde fica o outro tipo de multiplicidade.

Subagentes são execuções de agente em segundo plano iniciadas a partir de uma execução de agente existente.

O que é um subagente

• Uma chave de sessão própria sob o agente pai, um anúncio de volta ao solicitante por padrão, para revisão, e um registro de tarefa em segundo plano para cada execução; os objetivos são pesquisa em paralelo e trabalho lento com ferramentas sem bloquear a execução principal, isolamento por sessão e por sandbox opcional, e uma superfície de ferramentas difícil de usar mal.
• Contexto e consumo de tokens próprios: a nota de custo da documentação recomenda definir um modelo mais barato para os subagentes e manter o agente principal no melhor, e copiar a transcrição do solicitante para um filho apenas quando ele realmente precisar dela.
• Uma execução termina, uma sessão não: uma execução concluída fica somente leitura na Control UI, com um caminho de volta ao pai, e uma sessão visível persistente só é criada quando o usuário pede uma, não porque uma tarefa foi longa ou produziu um relatório.

Aninhamento e como os resultados voltam

Por padrão, os subagentes podem delegar recursivamente até a profundidade cinco, com ajustes para a profundidade de spawn, de um a cinco, os filhos ativos por agente, cinco por padrão e até vinte, um teto global de oito na faixa de concorrência, um tempo limite padrão de execução e um tempo limite de anúncio. O agente principal fica na profundidade zero, orquestradores abaixo do teto podem criar filhos, e uma folha no teto não pode. Os resultados sobem um nível por vez: um descendente anuncia ao pai, o pai sintetiza os filhos antes de anunciar para cima, e o agente principal entrega ao usuário. A documentação orienta os agentes a esperar eventos de conclusão em vez de fazer polling, e a responder a uma conclusão atrasada com o token silencioso de não resposta.

As ferramentas que um filho nunca recebe

• Sempre perdidas, qualquer que seja a profundidade: a ferramenta gateway, a lista de agentes, o status de sessão, os cartões de progresso, cron, message, o envio para sessões e as ferramentas de conversa. É uma negação rígida derivada do envelope de sessão do subagente a cada turno, e listas de permissões comuns não podem sobrescrevê-la.
• No teto de profundidade, também se perdem as ferramentas de subagentes, a lista de sessões, o histórico de sessões e o spawn, então a única forma de uma folha se comunicar é a cadeia de anúncios.
• A política de ferramentas dos subagentes pode negar mais ou definir um filtro final que apenas permite, mas esse filtro não pode devolver uma ferramenta que o perfil de ferramentas removeu; o navegador ausente do perfil coding é o exemplo da documentação.

As automações do OpenClaw cobre as execuções agendadas que muitas vezes criam esses filhos, e o guia da sandbox do OpenClaw, o isolamento que um filho pode herdar.

Múltiplos agentes versus subagentes

Vários agentes configurados ficam sob as entradas por agente da configuração, cada um podendo sobrescrever os padrões onde o schema permite, com canais e salas roteados para eles; as páginas de Discord e de Matrix mencionam o mapeamento de servidores e salas para agentes. Subagentes são filhos temporários de uma única execução, criados por uma ferramenta em vez de declarados em um arquivo. O arquivo de configuração do OpenClaw explica os dois compartimentos em que essas entradas ficam.

Na Diali

Na Diali, cada assistente é uma instância isolada própria, então múltiplos agentes significa vários assistentes, cada um com seus canais e seu espaço de trabalho, e os subagentes ficam dentro da execução de um único assistente, com as mesmas regras de profundidade e de ferramentas. O OpenClaw hospedado na Diali é o assistente, e a página de preços da Diali mostra como os assistentes são contados.

• Um filho roda na própria sessão e anuncia para cima.
• Profundidade cinco por padrão; uma folha não pode criar filhos.
• Cron, message, gateway e as ferramentas de sessão nunca ficam com um filho.