OpenClaw 429 报错怎么解决？长上下文限流的 3 个修复方法

遇到 OpenClaw 的 429 报错，先记住一个判断：OpenClaw 本身不对你限流，429 几乎都来自它背后调用的模型提供方。最典型的一种是 Anthropic 的长上下文限流，报错文本长这样：HTTP 429: rate_limit_error: Extra usage is required for long context requests。下面按现象、原因、解法、预防四步讲清。

现象确认：你遇到的是不是这种 429

打开日志先确认报错文本：

openclaw logs --follow
openclaw models status
openclaw config get agents.defaults.models

如果日志里出现的是 HTTP 429: rate_limit_error: Extra usage is required for long context requests，就是官方文档单独列出的「Anthropic 长上下文 429」，继续往下看。如果是别的文本，大概率是模型提供方的通用限流，跳到第三节最后一段。

原因：为什么长上下文会触发 429

按官方排查文档，这种 429 同时满足三个条件：

1. 你选用的 Anthropic 模型是支持正式版 1M 上下文的 Claude 4.x 模型（Opus 4.6/4.7/4.8、Sonnet 4.6），或者模型配置还带着旧版的 params.context1m: true
2. 当前 Anthropic 凭据不具备长上下文请求的资格
3. 请求只在长会话或长上下文运行时才失败，短对话可能一切正常

简单说：模型要走 1M 上下文的通道，但你的账号没有这个通道的使用资格，提供方就用 429 把请求拒了。

解法：官方给出的 3 个修复选项

官方文档给了三条路，按推荐顺序：

1. 用标准上下文窗口：切换到标准窗口模型，或从旧版模型配置里移除 context1m 参数
2. 换有资格的凭据：改用具备长上下文资格的 Anthropic 凭据，或直接改用 Anthropic API 密钥
3. 配置回退模型：给 Agent 配好 fallback 模型，Anthropic 长上下文请求被拒时任务还能继续跑

修完用 openclaw models status 确认当前模型和凭据状态，再跑一次原任务验证。

预防：下次怎么少踩坑

• 长会话场景默认配好回退模型，这是官方文档在 429 章节明确建议的做法
• 升级或回滚 OpenClaw 后遇到 401/429 组合报错，先跑 openclaw doctor --fix 清理过期的凭据影子配置
• 如果报错文本不是长上下文那种，而是普通 rate limit，那是提供方按用量限流：降低并发、减少重试频率，或换一个提供方即可，参考官方模型提供方文档的故障转移配置

关于 2.0 版本升级后的配置变化，也可以看这篇 OpenClaw 2.0 更新解读：8 大新功能与 2 个破坏性变更，避免升级后凭据配置失效。

装的过程中卡住的话，这篇 OpenClaw 怎么安装：官方脚本一键装好与报错速查收集了常见安装报错。用其他模型网关遇到同类问题，可以对照这篇 Ox Alpha 报错怎么办：429/超时/上下文超限解决方法。