Solução de problemas

“A Apple não pôde verificar se o Clawos está livre de malware”

O Clawos ainda não é notarizado pela Apple. Vá em Ajustes do Sistema → Privacidade e Segurança e clique em Abrir Mesmo Assim, ou rode xattr -dr com.apple.quarantine /Applications/Clawos.app no Terminal. Para evitar o aviso, instale com curl -fsSL https://clawos.vercel.app/install.sh | bash. Depois disso, o app abre normalmente.

O agente aparece como “não instalado”

Confirme que o comando funciona num terminal novo (claude --version). Depois, em Configurações, clique em verificar novamente. Veja também Agentes.

A sessão caiu ou mostra erro

Use Reiniciar sessão no painel — a conversa é retomada com o contexto. Se o erro for de login, o próprio chat diz como resolver; Agentes e login abre os controles de login.

Um MCP não funciona

Nas configurações do projeto, aba MCPs, clique em Testar: o resultado mostra as ferramentas disponíveis ou o erro exato. Confira também se os segredos referenciados estão definidos na aba Segredos.

A mesclagem da worktree foi recusada

Veja a mensagem no chat e Worktrees → Quando a mesclagem é recusada.

Gemini: “API key is missing”

Defina GEMINI_API_KEY no seu ambiente ou em ~/.gemini/.env e reinicie a sessão.

Onde ficam os meus dados?

Projetos, conversas, layouts e segredos ficam na pasta de dados do app (no macOS, ~/Library/Application Support/Clawos). A configuração de cada projeto fica no próprio projeto, em .clawos/project.yaml.

Ainda com problemas?

Abra uma issue no GitHub com o sistema, a versão do Clawos e a mensagem de erro.