OpenClaw 调用模型时出现“API rate limit reached. Please try again later”错误的原因和解决方案

OpenClaw 出现“API rate limit reached. Please try again later”错误，如下图，通常是由于调用的后端大模型服务（如 OpenAI、Anthropic、阿里云百炼等）触发了速率限制或配额耗尽。这属于服务商层面的限制，而非 OpenClaw 本身的问题。

错误原因

1、配额耗尽：使用的 API Key 对应的免费额度或付费套餐额度已用完（如 OpenAI、智谱的免费额度、阿里云百炼的 Coding Plan 套餐次数）。
2、高频调用：短时间内发送了过多请求，超过了服务商设定的每分钟/每秒请求数（RPM/RPS）限制。
3、配置错误：如果使用了阿里云百炼的 Coding Plan 套餐，但 Base URL 配置错误，导致请求被路由到了通用的 API 通道，从而触发更严格的限流。

解决方案

1、检查状态：在终端运行 openclaw models status，查看具体是哪个服务商被限流以及冷却倒计时。
2、重启服务：如果冷却时间过长，可以尝试重启 OpenClaw Gateway 来清除内部缓存状态：openclaw gateway restart。
3、降低频率：在代码中实现指数退避重试机制，或增加请求间隔。
4、升级套餐：如果经常遇到配额耗尽，建议升级 API 套餐或更换为更高配额的模型服务商。
5、配置 Fallback：在 openclaw.json中配置备用模型，当主模型被限流时自动切换到备用模型（如从 OpenAI 切换到 Anthropic）。