---
title: "Erro Authentication Failed — Resolver Autenticação"
url: "https://openclaw.ia.br/erros/auth-failed/"
markdown_url: "https://openclaw.ia.br/erros/auth-failed.MD"
description: "Como resolver erro de autenticação no OpenClaw. API keys, tokens e credenciais inválidas."
date: ""
author: ""
---

# 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ç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:**
```bash
# 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:**
```bash
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ápida

### 1. Ver Configuração Atual

```bash
cat ~/.openclaw/config.yaml
```

### 2. Testar Conectividade

```bash
# 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
```bash
openclaw config set anthropic.api_key "nova-key"
openclaw gateway restart
```

### Via Arquivo
```yaml
# ~/.openclaw/config.yaml
anthropic:
  api_key: "sk-ant-sua-nova-key"
```

### Via Variável de Ambiente
```bash
export ANTHROPIC_API_KEY="sk-ant-sua-key"
```

## Boas Práticas

### Segurança de Keys

```yaml
# 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

- [Configuração](/guias/configuracao/)
- [FAQ Técnico](/faq/tecnico/)
- [Troubleshooting](/troubleshooting/)