在使用OpenClaw调用OpenAI、Anthropic、Gemini、本地模型或OpenAI兼容接口时，如果出现 429 Too Many Requests、Rate limit exceeded、API 429、Quota exceeded、Request limit reached 等错误，说明当前请求频率超过API限制或账号额度不足。429限流是OpenClaw高并发运行、批量任务、Agent循环调用、多模型并行、Workflow自动化时最常见的问题之一。要彻底解决429错误，需要从请求频率、并发数、API额度、Key数量、模型选择、限速配置、重试策略、代理分流、负载均衡等多个方面进行调整。

一、429错误的常见原因

• 请求次数超过API限制
• Token使用量超过额度
• 并发数过高
• 单Key调用过多
• 账号余额不足
• 免费Key限制
• 模型限速
• 多Agent循环调用
• Workflow批量执行
• 代理IP被限流

二、确认API额度是否用完

部分429是额度不足。

检查：

• OpenAI Billing
• Anthropic Usage
• Gemini quota

如果余额为0：

• 必须充值
• 或更换Key

常见提示：

Quota exceeded
insufficient_quota
billing required

三、降低请求频率

OpenClaw默认可能并发较高。

可以降低：

• 并发线程
• Worker数量
• Agent循环速度
• Workflow批量数量

示例：

max_requests = 2

或：

concurrency = 1

四、增加API Key数量

单Key容易限流。

可以添加多个Key。

示例：

OPENAI_API_KEY_1
OPENAI_API_KEY_2
OPENAI_API_KEY_3

OpenClaw可以轮询使用。

五、使用Key轮换

推荐配置Key池。

API_KEYS=[
sk-1,
sk-2,
sk-3
]

调用时自动切换。

优点：

• 避免单Key限流
• 提高并发
• 适合批量任务

六、使用低成本模型

高级模型更容易限流。

例如：

• gpt-4 → 限制严格
• gpt-4o → 限制中
• gpt-4o-mini → 限制低
• gpt-3.5 → 限制低

建议：

fast = gpt-4o-mini

七、开启自动重试

429可以通过重试解决。

示例：

retry = 3
retry_delay = 5

效果：

• 避免瞬时限流
• 提高成功率

八、增加请求间隔

请求太快会429。

设置延迟：

delay = 1s

或：

sleep 2

适合：

• 批量生成
• Agent循环
• 自动化任务

九、使用代理分流

部分API按IP限流。

可以使用：

• 多IP代理
• 住宅IP
• 多出口服务器

效果：

• 减少429
• 提高并发

十、使用多Provider分流

OpenClaw支持多个模型。

示例：

fast = gpt-4o-mini
backup = claude
local = llama3

任务分流：

• 主模型
• 备用模型
• 本地模型

十一、限制Agent循环次数

Agent无限循环容易429。

设置：

max_steps = 5

或：

max_calls = 10

十二、限制Workflow批量数量

批量任务会瞬间触发限流。

建议：

batch = 1

或：

queue = true

十三、检查本地模型误用API

本地模型不应调用云API。

错误：

provider=openai

正确：

provider=ollama

十四、升级OpenClaw版本

新版本优化限流。

docker pull openclaw/openclaw:latest

docker compose up -d

十五、推荐稳定配置

OPENAI_API_KEY=sk-1
OPENAI_API_KEY_2=sk-2
OPENAI_API_KEY_3=sk-3

fast=gpt-4o-mini
smart=gpt-4.1
local=llama3

concurrency=1
retry=3
delay=1

使用Key池 + 限速 + 重试 + 分流，可以稳定运行OpenClaw并避免API 429限流错误。