Erro Authentication Failed — Resolver Autenticação

Como resolver erro de autenticação no OpenClaw. API keys, tokens e credenciais inválidas.

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çoAPI 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"}]}'
WhatsApp

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:

  1. Verifique token com @BotFather
  2. Crie novo bot se necessário
  3. Atualize config.yaml
Integrações (GitHub, Slack, etc.)

Causas:

  • Token expirado
  • Permissões revogadas
  • Scopes insuficientes

Solução:

  1. Gere novo token no serviço
  2. Verifique scopes necessários
  3. Atualize configuração
Verificação Rápida1. 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 CredenciaisVia 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áticasSeguranç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
  1. Gere nova key
  2. Atualize configuração
  3. Teste funcionamento
  4. 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.

Próximos Passos