Correção para subagentes não aparecerem no OpenClaw v2026.3.13

Problema: Subagentes invisíveis na v2026.3.13
Na versão 2026.3.13 do OpenClaw, alguns usuários relatam que apenas o agente principal aparece na lista de agentes, enquanto subagentes personalizados permanecem invisíveis. O problema parece estar com a descoberta automática de caminhos para membros personalizados do esquadrão.
Solução: Método de conexão forçada
Após analisar os logs, um membro da comunidade encontrou uma solução alternativa confiável envolvendo duas alterações de configuração.
1. Simplifique o openclaw.json
O analisador 2026.3 pode falhar quando a lista de agentes contém chaves extras como "path". Mantenha a lista mínima apenas com valores "id":
"list": [
{ "id": "main", "tools": { "alsoAllow": ["agents_list"], "deny": ["cron"] } },
{ "id": "librarian" },
{ "id": "matrix" }
]Importante: Verifique vírgulas finais e colchetes. A "list" deve terminar apenas com ] e depois } para a seção "agents".
2. Registro manual via runs.json
Se o sistema não detectar seus agentes, registre-os manualmente no seu .openclaw/subagents/runs.json (ou runs.json raiz dependendo da configuração). Defina seu status como "idle" para ativá-los:
{
"version": 2,
"runs": {
"librarian": {
"id": "librarian",
"path": "C:\\Users\\YOUR_USERNAME\\.openclaw\\subagents\\Librarian_Synapse.md",
"status": "idle"
}
}
}3. Verificação
Após fazer essas alterações, reinicie seu gateway e use o comando /agents. Seu esquadrão agora deve aparecer (por exemplo, mostrando "Agents (8)" em vez de apenas 1). Você pode então delegar tarefas usando a tag @agent_name.
📖 Read the full source: r/openclaw
👀 See Also

Jornada de Memória OpenClaw: Busca Integrada vs MemPalace para Recuperação de Sessão em Tempo Real
Um desenvolvedor compara o memorySearch integrado, QMD e MemPalace em um Intel Mac. A indexação em tempo real de sessões encontra problemas; ele adota uma estratégia de recall dividido com reindexação via cron.

As regras do SOUL.md desviam-se em sessões longas de agentes de IA e como corrigir isso
As regras do SOUL.md funcionam perfeitamente nas primeiras 10-15 mensagens, mas começam a se desviar por volta da mensagem 20-30, conforme o contexto da conversa sobrepõe o prompt inicial do sistema. A solução é usar /new de forma mais agressiva para redefinir as sessões antes de cada tarefa distinta.

Arquitetura Multi-Agente: Evitando a Armadilha do Agente Único em Sistemas de IA
Uma publicação no Reddit identifica o erro arquitetural comum de usar um único agente para múltiplas tarefas, o que leva a sistemas frágeis que exigem monitoramento constante. A solução proposta é um modelo de orquestrador-especialista, onde cada agente tem uma função específica e limitada.

OpenClaw Mega Cheat Sheet: Seu Portal para o Domínio da Programação em IA
Mergulhe na Mega Folha de Dicas do OpenClaw do r/openclaw—um guia abrangente repleto de dicas essenciais para entusiastas de programação de IA e automação.