Erro Authentication Failed — Resolver Autenticação
Como resolver erro de autenticação no OpenClaw. API keys, tokens e credenciais inválidas.
⏱️ 2 min de leitura
Erro: Authentication Failed
O OpenClaw não conseguiu autenticar com um serviço. Veja como resolver.
O Que Significa
Error: Authentication failed
Error: Invalid API key
Error: 401 Unauthorized
Error: Token expired or invalid
Suas credenciais estão incorretas, expiradas ou sem permissão.
Causas por Serviço
API de IA (Anthropic/OpenAI)
Causas:
- API key incorreta
- Key expirada ou revogada
- Conta sem créditos
- Key de organização errada
Solução:
# Verificar key configurada
cat ~/.openclaw/config.yaml | grep -i key
# Testar key Anthropic
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "content-type: application/json" \
-d '{"model":"claude-3-haiku-20240307","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'
Causas:
- Sessão expirada
- Deslogado do WhatsApp Web
- Número bloqueado
Solução:
openclaw whatsapp link # Reautenticar
Telegram
Causas:
- Token do bot inválido
- Bot deletado
- Token copiado errado
Solução:
- Verifique token com @BotFather
- Crie novo bot se necessário
- Atualize config.yaml
Integrações (GitHub, Slack, etc.)
Causas:
- Token expirado
- Permissões revogadas
- Scopes insuficientes
Solução:
- Gere novo token no serviço
- Verifique scopes necessários
- Atualize configuração
Verificação Rápida
1. Ver Configuração Atual
cat ~/.openclaw/config.yaml
2. Testar Conectividade
# Anthropic
curl -I https://api.anthropic.com
# OpenAI
curl -I https://api.openai.com
3. Validar Key
Acesse os dashboards:
- Anthropic: console.anthropic.com
- OpenAI: platform.openai.com
- GitHub: github.com/settings/tokens
Atualizar Credenciais
Via CLI
openclaw config set anthropic.api_key "nova-key"
openclaw gateway restart
Via Arquivo
# ~/.openclaw/config.yaml
anthropic:
api_key: "sk-ant-sua-nova-key"
Via Variável de Ambiente
export ANTHROPIC_API_KEY="sk-ant-sua-key"
Boas Práticas
Segurança de Keys
# Sim Use variáveis de ambiente
anthropic:
api_key: ${ANTHROPIC_API_KEY}
# Não Evite hardcoded
anthropic:
api_key: "sk-ant-xxxxx"
Rotação de Keys
- Gere nova key
- Atualize configuração
- Teste funcionamento
- Revogue key antiga
Permissões Mínimas
Use tokens com apenas as permissões necessárias.
Erros Específicos
“Invalid API key provided”
Key está errada. Verifique se copiou corretamente.
“You exceeded your current quota”
Sem créditos. Adicione saldo na conta.
“This model is not available”
Key não tem acesso ao modelo. Verifique tier da conta.
“Token has been revoked”
Token foi revogado. Gere um novo.