1. 模型与API配置检查
- 若使用国内模型,需确认模型配置中是否添加了
"reasoning": false,部分国内模型不支持默认的推理模式,添加后可解决无回复问题。- Windows系统:打开PowerShell,输入notepad $env:USERPROFILE\.openclaw\openclaw.json,用记事本打开配置文件
- Mac/Linux/阿里云:在终端输入nano ~/.openclaw/openclaw.json,用nano编辑器打开配置文件
-
检查绑定的大模型API余额是否充足,若余额不足会导致无法正常回复,充值后即可
-
认证与参数配置核查
- 确认API密钥格式、前缀、权限及请求头Authorization字段配置正确,密钥错误是导致无回复的常见原因。
- 检查请求参数是否符合OpenAI兼容规范,比如messages必须为包含role和content的对象数组,model需为中转服务支持的名称。
- 平台与服务器状态排查
- 若集成在钉钉、飞书等平台,检查平台特定配置,比如钉钉的
access_token是否正确、AI卡片模板是否符合平台规范;飞书需确认长连接回调配置是否恰当。 - 查看服务器资源是否耗尽,比如内存、端口、磁盘空间不足也会导致服务无响应
5 .调试日志分析
启用调试日志捕获请求/响应全过程,重点关注状态码与响应头,通过日志信息定位具体故障环节。