OpenClaw & Moltbook FAQ

Após a instalação, verifique: 1. Execute `openclaw health` ou `openclaw status` (CLI) ou verifique o status de saúde no Desktop 2. Procure marcas verdes em todos os serviços 3. Verifique se o gateway está acessível (padrão: http://127.0.0.1:18789) 4. Confira os logs por mensagens de erro Se todas as verificações passarem, você está pronto para configurar canais.

Top 5 problemas de inicialização: 1. Porta já em uso (outro app usando 18789) 2. Chaves API faltando ou inválidas 3. Permissões insuficientes (tente rodar como admin) 4. Firewall bloqueando conexões 5. Dependências desatualizadas (Node.js v22+ necessário) Verifique os logs primeiro - geralmente apontam o problema exato.

Soluções: 1. Encontre e pare o processo conflitante: • Mac/Linux: `lsof -i :18789` depois `kill [PID]` • Windows (WSL): `lsof -i :18789` depois `kill [PID]` 2. Ou mude a porta do OpenClaw: • Use `openclaw gateway --port 18790` ao iniciar • Ou especifique `--gateway-port 18790` durante onboard

Tente estes passos em ordem: 1. Verifique logs: `openclaw logs --follow` para ver mensagens de erro 2. Reconfigure: execute `openclaw configure` para resetar 3. Reinstale: `npm install -g openclaw@latest` 4. Verifique notas de versão por mudanças importantes 5. Se ainda falhar, reporte com logs no GitHub Issues

OpenClaw usa principalmente `~/.openclaw/openclaw.json` para configuração. Problemas comuns: 1. Serviço não reiniciado após mudanças na config 2. Caminho do arquivo de configuração errado 3. Erros de sintaxe JSON (vírgulas, aspas faltando) 4. Variáveis de ambiente devem ser passadas via parâmetros de onboard Verificar config: execute `openclaw status` para ver configurações ativas.

Pense nisso como um restaurante: • Modelo = O chef (IA que gera respostas) • Canal = A entrada (WhatsApp, Telegram, etc.) • Gateway = A recepção (recebe e roteia requisições) • Skills = Habilidades especiais (busca web, execução de código, etc.) Você precisa de pelo menos um modelo e um canal. Gateway roda automaticamente. Skills são melhorias opcionais.

A forma mais fácil é executar o assistente de configuração interativo: ``` $ openclaw onboard ``` O assistente guia você através de: • Selecionar um provedor de modelo IA (Anthropic/OpenAI etc.) • Inserir sua chave API • Instalar e iniciar o serviço gateway Após configurar, conecte um canal com `openclaw channels login telegram`. O gateway padrão se vincula a 127.0.0.1:18789 (apenas acesso local - seguro).

No Desktop: Configurações → Skills → Alternar on/off No CLI: • Listar skills disponíveis: `openclaw skills list` • Instalar um skill: `openclaw skills install [skill-name]` • Habilitar um skill: `openclaw skills enable [skill-name]` Dicas de segurança: • Desabilite skills que você não precisa • Revise permissões do skill antes de habilitar • Teste novos skills primeiro em ambiente seguro • Alguns skills podem executar código - habilite com cuidado

Trocando modelos: 1. Execute `openclaw onboard` novamente para reconfigurar com novo provedor 2. Ou edite configurações agents.defaults.model em `~/.openclaw/openclaw.json` 3. Reinicie o serviço: `openclaw gateway status` para verificar Se novo modelo falhar: • Execute `openclaw models status` para verificar conexão do modelo • Verifique validade da chave API no site do provedor • Verifique ortografia do nome do modelo (ex. `anthropic/claude-opus-4-5`) • Verifique limites de taxa ou cota na sua conta

Lista de segurança: ✓ Mantenha gateway em localhost (127.0.0.1) por padrão ✓ Nunca exponha porta diretamente para internet pública ✓ Se acesso remoto necessário, use: • VPN ou túnel SSH • Proxy reverso com autenticação • Cloudflare Tunnel ✓ Habilite autenticação se disponível ✓ Use HTTPS em produção

Tente estas correções: 1. Certifique-se que telefone e computador estão na mesma rede 2. Atualize o código QR (eles expiram rápido) 3. Atualize WhatsApp para a última versão no telefone 4. Limpe cache do navegador se usando interface web 5. Tente escanear em ambiente bem iluminado 6. Desative VPN temporariamente Se ainda falhar, tente o método de código de link do telefone.

Problemas de sessão geralmente são causados por: 1. Telefone offline ou em modo de suspensão 2. WhatsApp deslogado no telefone 3. Usando WhatsApp Web em outro dispositivo 4. Instabilidade de rede Soluções: • Mantenha telefone conectado a WiFi estável • Desative otimização de bateria para WhatsApp • Não abra WhatsApp Web em outro lugar • Verifique atualizações do app WhatsApp

Comportamento de grupo geralmente é intencional: • Verifique se respostas de grupo estão habilitadas na config • Bot pode precisar de @menção para responder em grupos • Config padrão pode desabilitar mensagens de grupo por segurança Para habilitar: • Habilite respostas de grupo nas configurações do Desktop • Ou gerencie permissões de grupo via `openclaw pairing` • Teste com um grupo pequeno primeiro para garantir que funciona

Bots do Telegram têm Modo de Privacidade habilitado por padrão: 1. Abra @BotFather 2. Envie /mybots 3. Selecione seu bot 4. Bot Settings → Group Privacy → Turn OFF Alternativamente, faça o bot um admin do grupo - admins podem ver todas as mensagens independente do modo privacidade.

Passos simples: 1. Abra Telegram, busque @BotFather 2. Envie /newbot 3. Escolha um nome (nome de exibição) 4. Escolha um username (deve terminar em 'bot') 5. Copie o token API fornecido 6. Adicione token à sua config do OpenClaw Opcional: Use /setcommands para adicionar sugestões de comandos.

Geralmente um problema de intents: 1. Vá ao Discord Developer Portal 2. Selecione sua aplicação → Bot 3. Habilite estes Privileged Intents: • MESSAGE CONTENT INTENT • SERVER MEMBERS INTENT (se necessário) 4. Salve e reinicie seu bot Verifique também: bot tem permissão de Ler Mensagens no canal.

Intents obrigatórios: • Guilds - info básica do servidor • Guild Messages - receber mensagens • Message Content - ler texto das mensagens (PRIVILEGIADO) Opcional: • Guild Members - info de usuários (PRIVILEGIADO) • Direct Messages - suporte a DM Nota: Intents privilegiados requerem verificação para bots em 100+ servidores.

Scopes mínimos de Bot Token: • chat:write - enviar mensagens • app_mentions:read - responder a @menções • channels:history - ler mensagens do canal • im:history - ler mensagens DM Event Subscriptions: • message.channels • message.im • app_mention Comece mínimo, adicione mais apenas quando necessário.

401 significa falha de autenticação. Verifique: 1. A chave API está correta (sem espaços extras) 2. A chave não expirou ou foi revogada 3. A chave tem permissões/scopes necessários 4. Você não está atingindo limites de taxa 5. A conta tem créditos/cota suficientes Teste sua chave diretamente com a API do provedor primeiro.

Diagnostique passo a passo: 1. Teste o modelo diretamente (curl/Postman) - se lento, é o modelo 2. Verifique sua velocidade de internet e latência 3. Tente um modelo diferente (GPT-3.5 é mais rápido que GPT-4) 4. Verifique página de status do provedor por interrupções Soluções: • Aumente configurações de timeout • Use streaming para respostas longas • Tente um provedor de modelo diferente

Procure estes padrões nos logs: • 'FATAL' ou 'PANIC' - erros críticos • 'OOM' - sem memória • 'ECONNREFUSED' - não consegue conectar a dependência • Stack traces - erros de código Soluções comuns: • Aumente alocação de memória • Corrija erros de configuração • Atualize para última versão • Verifique disponibilidade de serviços externos

Solução de problemas de config: 1. Você reiniciou o gateway? (Necessário para maioria das mudanças) 2. A sintaxe JSON está correta? (Verifique vírgulas, aspas) 3. Arquivo de config certo? (Deve ser `~/.openclaw/openclaw.json`) 4. O gateway está rodando? (`openclaw gateway status`) Verificar config: • `openclaw status` - verificar status geral • `openclaw models status` - verificar conexões de modelo • `openclaw health` - verificação de saúde

Localizações dos logs: • Desktop: Exibir → Logs (ou Configurações → Abrir Pasta de Logs) • CLI: `~/.openclaw/logs/` ou stdout • Docker: `docker logs [container]` Palavras-chave de erro importantes: • ERROR, FATAL, PANIC - problemas críticos • timeout, ETIMEDOUT - problemas de conexão • 401, 403, 429 - problemas de auth/limite de taxa • ENOENT - arquivo/caminho faltando

Inclua no seu relatório: 1. Versão do OpenClaw (`openclaw --version`) 2. Sistema operacional e versão 3. Passos para reproduzir 4. Comportamento esperado vs real 5. Logs relevantes (remova info sensível!) 6. Trecho de config (remova chaves API!) Envie para: página do GitHub Issues Para problemas de segurança: email para contato de segurança diretamente

Riscos de exposição pública: • Qualquer um pode enviar requisições para sua IA • Chaves API podem ser extraídas • Potencial de abuso (spam, conteúdo ilegal) • Explosão de custos por uso não autorizado • Responsabilidade legal por ações do bot Opções de acesso remoto seguro: • VPN (recomendado) • Túnel SSH • Cloudflare Tunnel • Proxy reverso com auth

Lista de segurança: 1. É de fonte oficial/verificada? 2. Verifique o código fonte se disponível 3. Leia avaliações/issues de outros usuários 4. Entenda quais permissões são solicitadas 5. Teste primeiro em ambiente isolado Sinais de alerta: • Solicita permissões desnecessárias • Código ofuscado/minificado • Sem código fonte disponível • Sem feedback da comunidade

Aja imediatamente: 1. REVOGUE a chave no site do provedor AGORA 2. Gere uma nova chave 3. Atualize todas suas configs com a nova chave 4. Verifique histórico de uso por chamadas não autorizadas 5. Revise como vazou (histórico git? repo público?) Prevenção: • Nunca faça commit de chaves no git • Use arquivos .env (no gitignore) • Use gestão de segredos em produção

Padrões seguros: • Gateway vinculado apenas a localhost (127.0.0.1) • Skills desabilitados por padrão • Mensagens de grupo desabilitadas inicialmente • Limitação de taxa habilitada • Logging habilitado (para auditoria) • Permissões mínimas para bots de canal Lembre-se: comece restritivo, alivie apenas quando necessário.