OpenClaw排查模型调用失败

OpenClaw 调用模型失败时，界面上看到的可能只是一句“请求失败”或“无返回”，但背后的原因并不一样。认证失败、额度不足、接口地址错误、模型名称不匹配、请求超时、网络波动、上下文过长，都可能让同一个任务无法完成。

一、先看错误类型

排查模型调用失败，第一步是把错误类型分出来。401 通常指向认证失败，429 多半与限流或额度有关，超时可能是模型响应慢或任务过长，返回为空则要检查模型配置和响应格式。

二、401 认证失败怎么处理

先检查 API Key 是否复制完整，尤其是首尾空格、换行、隐藏字符和过期密钥。然后确认该密钥是否有调用目标模型的权限。如果使用兼容接口，还要检查 Base URL 和模型名称是否匹配。

三、429 限流或额度不足怎么处理

429 常见于请求频率过高、并发任务太多或账号额度不足。不要把所有失败都当作系统故障。先进入服务商后台查看额度、速率限制和调用记录。团队多人共用一个密钥时，建议把测试、正式、批量任务分开配置。

四、超时和返回为空怎么定位

可以用最小化任务测试：只发送一句简单问题，确认模型是否能返回。如果简单问题能返回，复杂任务超时，就要减少输入内容、拆分文件、降低单次任务规模，或适当增加超时时间。返回为空时要查看日志里的原始状态码和响应内容。

五、建议保留排查记录

每次排查模型调用失败，建议记录时间、模型名称、错误状态码、任务类型、输入长度、是否重试、最终处理方法。这样下一次出现类似问题时，不需要从头猜。

六、常见问题

模型调用失败一定是 OpenClaw 问题吗？ 不一定。密钥、额度、接口地址、模型服务状态和任务内容都可能导致失败。

429 能不能靠刷新页面解决？ 通常不能。应检查限流和额度，并降低并发或等待恢复。