During your use of OPenClaw, both API call anomalies and account login issues can interrupt your workflow. This article summarizes the most common error types and their corresponding solutions, helping you quickly get back on track without unnecessary hassle.
API Call Errors: Handling 403, 429, and 500 Codes
An API request returning a 403 error usually indicates insufficient permissions, most commonly due to an incorrectly configured or expired API key. Check that the key is enabled in the settings panel and confirm that the IP whitelist is not blocking your current network. A 429 error means you have exceeded the rate limit by sending too many requests; wait at least 60 seconds before retrying, or reduce your request frequency. A 500 error is a server-side issue often caused by temporary glitches—simply wait a few minutes and retry. If the 500 error persists, contact support to verify service status.
Login Authentication Failures: Wrong Password & Account Lock
If you forget your password, use the "Forgot Password" link on the registered email to reset it. If you see "Account Locked," it is usually triggered by multiple incorrect password attempts as a security measure. Wait 15 minutes for automatic unlocking, or contact official support for manual unlocking. Additionally, some users may trigger the system due to an abnormal IP address caused by using a proxy; disable the proxy or switch to your usual network environment and try again.
