OpenClaw Solución de Problemas — Guía de Configuración API Key

🔧 Solución de Problemas Comunes

¿Configuraste la API Key pero hay error? No te preocupes, aquí están los problemas comunes.

Errores Comunes y Soluciones

❌ 401 Unauthorized / Invalid API Key

Razón:API Key inválida o expirada.

Verifica si la clave se copió completa (sin espacios o caracteres faltantes)
Confirma que la clave no esté deshabilitada o eliminada
Confirma que baseUrl y API Key coincidan (no metas la clave OpenAI en dirección Anthropic)
La clave de Plan de Programación debe usar baseUrl de Plan de Programación, no la confundas

❌ 429 Too Many Requests / Rate Limited

Razón:Las solicitudes son demasiado frecuentes, superaste el límite de velocidad.

Espera un rato e intenta de nuevo
Si frecuentemente eres limitado, considera actualizar a Plan de Programación (límite más alto)
o configura múltiples proveedores, dispersa las solicitudes

❌ 402 Payment Required / Insufficient Balance

Razón:Saldo insuficiente.

Ve a la plataforma correspondiente a recargar
Verifica si hay facturas sin pagar
Verifica si la cuota gratuita ya se agotó

❌ Connection Timeout / Network Error

Razón:Problema de Conexión de Red.

Proveedores internacionales (OpenAI, Anthropic, Gemini) pueden necesitar VPN en China
Proveedores China doméstica (DeepSeek, MiniMax, etc.) deberían conectar directamente sin problema
Verifica si baseUrl es correcto, ¿hay errores de ortografía?
Intenta curl Comando para probar conectividad

❌ 400 Bad Request / Invalid Model

Razón:Nombre del modelo incorrecto, o tu cuenta no tiene acceso a ese modelo.

Verifica si el nombre del modelo en configuración de models es correcto
Confirma si tu cuenta/plan soporta ese modelo
Consulta la lista de modelos disponibles en la página de cada proveedor

Técnicas de Debugging

1. Verifica configuración actual:

cat ~/.openclaw/openclaw.json

2. Prueba conectividad API:

# 测试 DeepSeek
curl -s https://api.deepseek.com/v1/models -H "Authorization: Bearer sk-tu-clave"

# Prueba OpenAI
curl -s https://api.openai.com/v1/models -H "Authorization: Bearer sk-tu-clave"

3. Ver logs OpenClaw:

openclaw logs

4. Reinicia gateway:

openclaw gateway restart

💡 ¿Aún no puedes resolverlo?La mayoría de problemas son causados por baseUrl incorrecto o API Key no copiada completamente. Compara cuidadosamente con los ejemplos de configuración en la página de cada proveedor.