OpenClaw调用免费模型遇限流需三步应对：先用openclaw status --api-usage查实时用量，再用openclaw config show rate-limit确认限速配置源，最后通过配额熔断、psutil看门狗、指数退避等策略规避免费模型限流。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在用OpenClaw调用Qwen、Claude免费版或GitHub托管的开源模型时，突然收到“API rate limit reached”或“1305:该模型当前访问量过大”，不是模型挂了，而是你没监控调用频率，已踩进平台级限流红线。
实时查看当前模型的API用量
第一步：运行命令查看实时配额消耗情况：openclaw status --api-usage。
这会输出当前活跃认证档案（如profile_1）的daily_requests_used、rpm_remaining和tpm_remaining三项关键值。注意：若显示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，否则仅记录不拦截】
设为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。
第三步：对高频Skill做请求合并
例如飞书消息推送类Skill，不要每条消息单独调用/message/v4/send，改用/batch/message/send接口——OpenClaw v0.23+已内置batch_mode: true开关，开启后自动聚合同类型请求，单次调用可发20条消息，将rpm消耗降低95%。
