当您使用 OpenClaw 调用 Qwen、Claude 免费版或 GitHub 托管的开源模型时，若突然遇到“API rate limit reached”或“1305:该模型当前访问量过大”提示，请不要惊慌——这并非模型故障，而是您未对调用频率进行有效监控，误触了平台级限流红线。如何解决？三步走：首先查看实时用量，其次确认限速配置来源，最后通过配额熔断、psutil 看门狗、指数退避等策略从容应对，确保 API 调用平稳运行。

实时监测当前模型的 API 用量与配额消耗

第一步，执行一条命令查看配额消耗情况：openclaw status --api-usage。该命令会输出当前活跃认证档案（例如 profile_1）的三项关键指标——daily_requests_used（当日已用请求数）、rpm_remaining（本分钟剩余请求数）和 tpm_remaining（本分钟剩余 token 数）。请注意：若显示 rpm_remaining: 0，则表示本分钟请求额度已完全耗尽，此时重试无效，必须等待额度自动重置。

第二步，确认当前生效的速率限制配置来源：openclaw config show rate-limit。此命令会输出实际加载的 rpm_limit 与 tpm_limit 数值——这些值可能来自 providers 块、auth_profiles 块，或被环境变量覆盖。若不通过此命令核实，仅修改 openclaw.json 文件可能根本不会生效。

启用自动告警与阈值拦截机制

方法一：在 auth_profiles 中设置硬性日用量熔断

编辑 openclaw.yaml，为免费账号配置 quota.daily_requests 并启用强制拦截：

auth_profiles:
- name: "qwen-free"
  qwen_oauth:
    client_id: "xxx"
    client_secret: "yyy"
  quota:
    daily_requests: 1000
    enforce_quota: true   # 【必须设为true，否则仅记录不拦截】

将 enforce_quota 设为 true 后，一旦当日调用次数达到 999 次，OpenClaw 将直接拒绝后续请求，返回 403 Quota Exceeded，从而避免触发服务商侧的封禁惩罚，保障账户安全。

方法二：部署 psutil 看门狗实现本地资源联动

执行：openclaw skill install psutil-watchdog → 启动技能：openclaw skill start psutil-watchdog。该技能每 10 秒采集一次当前进程的 API 调用频次（基于 /tmp/openclaw-api-log 滚动日志），当检测到连续 3 分钟内的 RPM 超过 80% 限额时，自动触发 openclaw config set model.provider deepseek 切换至备用模型。整个过程不依赖外部服务，纯本地闭环运行，响应迅速。

规避免费模型限流的三步实操指南

第一步：强制启用指数退避重试机制

在 openclaw.json 的 api_config.rate_limit 下添加如下配置：

"retry_strategy": "exponential_backoff",
"max_retries": 5,
"base_delay_ms": 1000

这能有效防止因瞬时并发导致的 429 错误被重复提交——第一次失败后等待 1 秒，第二次等待 2 秒，第三次等待 4 秒，依此类推。若不添加此配置，脚本的暴力轮询将加速触发平台封禁，得不偿失。

第二步：关闭 QMD 语义记忆的自动上下文注入

免费模型的 token 配额极为紧张，而 QMD 默认会在每轮对话中自动注入最近 5 轮历史，极易超出 TPM 限额。执行以下命令即可关闭：openclaw config set qmd.enabled false，一步到位，释放宝贵 token 资源。

第三步：对高频 Skill 进行请求合并

以飞书消息推送类 Skill 为例，请勿每条消息单独调用 /message/v4/send 接口，应改用 /batch/message/send 接口——OpenClaw v0.23+ 已内置 batch_mode: true 开关，开启后自动聚合同类型请求，单次调用可发送 20 条消息，将 RPM 消耗降低 95%。这才是合理利用免费配额、节省调用次数的硬核策略。