Troubleshooting

Esta página só agrega os pontos de solução de problemas que já existem nas seções reais da documentação. Cada link leva direto à seção correspondente.

• Instalação — erros ao instalar ou compilar: veja Instalação → Troubleshooting.
• Gateway / deploy — servidor que não sobe, portas, variáveis de ambiente: Deployment → Solução de Problemas (inclui erros de chave de API).
• Perfis de execução — pod isolado, raiz do MCP filesystem, boot recusado: Perfis de execução → Troubleshooting.
• MCP — handshake, tools que não aparecem, stdio vs HTTP: MCP → Troubleshooting.
• WhatsApp — pareamento, dispositivo vinculado, política de acesso: WhatsApp → Troubleshooting.
• Voz (STT/TTS) — servidores locais de voz, diagnósticos: Voz → Diagnostics e Voz → Troubleshooting.

Não achou o seu caso? O config check e o garra config check apontam problemas de configuração com o próximo passo sugerido, e as issues no GitHub são o canal para relatar algo novo.