在使用OpenClaw做模型接入或者本地AI部署的时候，有些用户会突然遇到一个很“卡壳”的问题：界面能打开，但一发送消息就报错——Agent failed before reply，完全不给回复。这种情况第一次遇到确实有点懵，其实它并不是复杂故障，大多数都和认证或配置有关，理清思路很快就能解决。

一、重新登录授权

OpenClaw接入像Qwen这类模型时，需要用OAuth授权。如果授权token过期或失效，就会直接导致模型调用失败。操作步骤：

1、打开终端（或命令行）。

2、输入以下命令重新授权：openclaw models auth login --provider qwen-portal。

3、按提示完成登录（通常会跳转浏览器授权）。

4、授权完成后返回OpenClaw重新发起请求。

5、如果你是在Web界面使用，也可以直接进入【模型配置】，找到对应模型。

6、点击重新登录或重新绑定账号。

二、检查模型接入配置

如果模型的API Key填错、格式不对，或者模型名称配置错误，也会导致Agent直接失败。操作步骤：

1、打开OpenClaw后台【设置】或【模型配置】。

2、检查以下内容：

API Key是否填写正确

Provider是否选择正确（如qwen-portal）

模型名称是否匹配

3、保存配置后重新测试。

4、如果你不确定哪里填错，其实可以用【OpenClaw部署助手】来重新配置一遍模型接入，它会自动帮你校验格式和环境，比手动填更稳。

 

三、检查网络与代理设置

模型调用本质是网络请求，如果你的网络环境不稳定，或者代理配置错误，就会导致请求失败，从而报这个错误。操作步骤：

1、确认当前网络可以正常访问模型服务。

2、如果使用代理的话，需要检查代理地址和端口是否正确。

3、确认代理已开启。

4、在OpenClaw中检查【代理设置】是否配置正确。

5、重启OpenClaw服务后再次尝试。

四、切换模型或检查服务状态

有时候不是你本地的问题，而是模型服务本身挂了或者接口异常。操作步骤：

1、尝试切换到其他模型（如不同provider）。

2、查看OpenClaw顶部是否有服务异常提示。

3、等待一段时间后重试。

4、如果多个模型都失败，那基本可以判断是环境或配置问题，而不是单个模型。

五、更新或重新部署环境

OpenClaw运行依赖本地环境，如果版本不一致或组件缺失，也可能导致调用失败。操作步骤：

1、检查OpenClaw版本（建议使用最新版本）。

2、执行更新命令或重新安装。

3、如果不想手动折腾环境，可以直接用OpenClaw部署助手重新部署，完成后再重新配置模型。

常见问题解答（FAQ）

1、为什么刚开始能用，后来突然报错？

大概率是OAuth token过期，需要重新登录授权。

2、所有模型都失败，是哪里的问题？

优先检查网络、代理和整体环境配置，而不是单个模型。

3、重新登录还是不行怎么办？

建议检查API Key或直接用OpenClaw部署助手重新配置模型。

“Agent failed before reply”这个报错，看起来复杂，其实核心就几件事：认证过期、配置错误、网络异常、环境问题。建议优先从OAuth重新登录开始排查，再检查模型配置，如果不想一步步折腾，直接用OpenClaw部署助手一键检测和修复，是效率比较高的解决方式。

OpenClaw部署助手https://www.160.com/qddownload/3007/openclawtool-windows.exe