Preguntas frecuentes sobre claves API
Problema: La clave API dejó de funcionar de repente, ¿qué hago?
Las claves API de OpenClaw pueden desactivarse por caducidad, revocación manual o restricciones de seguridad. Primero, inicie sesión en la consola de OpenClaw y revise el estado de la clave en la página "API Keys". Si aparece como "Inactive", genere una nueva clave y reemplace la anterior. Nota: cada cuenta puede tener hasta 5 claves activas; al rotarlas con frecuencia, recuerde eliminar las claves antiguas que ya no use.
Problema: Al llamar a la API recibo un error 401, ¿cómo lo soluciono?
El código 401 indica un fallo de autenticación. Verifique que el encabezado "Authorization" tenga el formato "Bearer <su_api_key>" y que la clave no contenga espacios adicionales. Si usa variables de entorno para almacenar la clave, compruebe que el nombre de la variable esté escrito correctamente. Además, las claves de cuentas de prueba gratuita pueden desactivarse automáticamente al finalizar el período de prueba; deberá actualizar a un plan de pago para seguir usándolas.
Facturación y cargos
Problema: ¿Por qué el monto de mi factura es mayor de lo esperado?
OpenClaw cobra por tokens, y los precios varían según el modelo. Un importe superior al previsto puede deberse a: 1) haber usado un modelo de alta precisión (como Claw-4) sin verificar su precio unitario; 2) haber incluido muchos prompts del sistema o historiales de conversación en las solicitudes, lo que aumenta el número de tokens consumidos. Se recomienda establecer un límite de "max_tokens" en las solicitudes a la API y revisar el desglose diario/horario en la página "Usage" de la consola. Si detecta un pico anómalo, compruebe si hay errores de bucle en su código.
Problema: Después de suscribirme, ¿cómo solicito una factura fiscal?
En la configuración de su cuenta de OpenClaw, vaya a la sección "Billing", haga clic en "Invoice History" y seleccione el registro de factura que desea facturar. Puede completar el nombre de la empresa, el número de identificación fiscal y la dirección registrada. Nota: las cuentas personales solo pueden emitir facturas a nombre del individuo; tras la verificación empresarial, podrá elegir facturas de empresa. Las facturas suelen enviarse al correo electrónico registrado entre 3 y 5 días hábiles después de la solicitud.
Seguridad de la cuenta y gestión de permisos
Problema: ¿Cómo evitar que otros usen mi clave API de forma indebida?
OpenClaw ofrece la función "IP Whitelist" en la interfaz "Security", donde puede establecer el rango de direcciones IP autorizadas para llamar a la API. Si no conoce su IP, utilice el mecanismo de "claves temporales" con un período de validez (por ejemplo, 1 hora). Además, se recomienda no escribir la clave API directamente en el código frontend; use un proxy backend en su lugar. Revise periódicamente los "API Logs" en la consola para detectar orígenes de llamadas anómalos.
Problema: Mi cuenta fue bloqueada, ¿cómo la desbloqueo?
El bloqueo suele deberse a varios intentos fallidos de inicio de sesión o a superar el límite de frecuencia de llamadas a la API. Puede probar los siguientes pasos: 1) esperar de 15 a 30 minutos para que se desbloquee automáticamente (bloqueo temporal); 2) restablecer la contraseña e iniciar sesión de nuevo; 3) si aparece "Suspended", contacte al soporte de OpenClaw indicando el correo electrónico registrado y explique la situación. Nota: las infracciones de los términos de servicio (como registros masivos o scraping malintencionado) pueden conllevar una suspensión permanente sin posibilidad de apelación.
