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.