排查 Openclaw 连接本地 Ollama 无响应
遇到 WebUI 点击没反应或者一直转圈的情况,别急着重装,通常是环境配置或版本对不上。按下面几个关键点顺一遍,基本能定位问题。
版本对齐
前端页面和后台 Gateway 版本必须匹配,不然接口调用会静默失败。先跑一下更新命令,把依赖拉齐:
npm update openclaw
更新完记得查一下当前装的是啥版本,确认是不是最新的:
npm list openclaw
看到类似 [email protected] 这种输出才算稳。
本地服务通不通
有时候不是 Openclaw 的问题,是 Ollama 根本没起起来。默认监听在 11434 端口,用 curl 测一下最直观:
curl http://127.0.0.1:11434/v1/models
要是能返回模型列表的 JSON 数据,说明后端链路是通的;要是连不上,先去检查 Ollama 进程有没有挂掉。
启动参数别漏了
环境变量配错也是常事,特别是路径指向不对的时候。直接用 PowerShell 显式指定状态目录和配置文件,再启动网关:
$env:OPENCLAW_STATE_DIR="e:\\指定路径\\.openclaw"
$env:OPENCLAW_CONFIG_PATH="e:\\指定路径\\.openclaw\\openclaw.json"
node ./node_modules/openclaw/dist/index.js gateway
记得把路径换成你实际的文件夹位置。跑起来之后盯着终端看日志,有报错直接看第一行,通常能发现是权限还是路径问题。

