Openclaw 集成本地 Ollama 与 Qwen WebUI 连接无响应排查
当使用 Openclaw 前端版本对接本地 Ollama 服务,并尝试通过 Qwen WebUI 进行对话时,如果遇到没有任何反应的情况,通常需要从依赖版本、服务连通性以及环境变量配置三个维度进行排查。下面按照实际调试顺序整理关键步骤。
1. 确保 Openclaw 为最新稳定版
很多时候旧版本的网关或客户端存在已知 Bug,升级是解决兼容性问题的首选方案。
# 更新到最新版本
npm update openclaw
# 确认当前安装版本
npm list openclaw
执行后检查输出,例如:
2fen@ E:\2fen
└── openclaw@2026.2.22
如果版本号较旧,建议重新安装或强制更新。
2. 验证本地 LLM 服务状态
Openclaw 需要调用本地 Ollama 的 API 接口。在启动网关前,必须确认 Ollama 服务已正常监听。
启动服务
确保 vLLM 或 Ollama 服务已成功启动,默认监听地址通常为:
http://127.0.0.1:11434/v1
连通性测试
使用 curl 命令直接请求模型列表接口,验证后端是否可访问:
curl http://127.0.0.1:11434/v1/models
如果返回 JSON 数据包含模型列表,说明网络层和 API 层均正常;若超时或拒绝连接,请检查防火墙设置或服务端口占用情况。
3. 配置环境变量并启动 Gateway
Openclaw 网关运行时需要明确指定状态目录和配置文件路径。Windows 环境下建议使用 PowerShell 设置环境变量。
设置环境变量
将 OPENCLAW_STATE_DIR 和 OPENCLAW_CONFIG_PATH 指向有效的本地路径(注意转义反斜杠):
$env:OPENCLAW_STATE_DIR="e:\指定路径\.openclaw"
$env:OPENCLAW_CONFIG_PATH="e:\指定路径\.openclaw\openclaw.json"
提示:请确保指定路径下的文件夹已创建,且配置文件
openclaw.json存在且格式正确,否则网关可能无法初始化。
启动网关进程
完成上述配置后,直接在项目根目录下运行 gateway 脚本:
node ./node_modules/openclaw/dist/index.js gateway
观察终端日志输出,若出现 Listening on... 或类似成功信息,则表明网关已就绪。此时再尝试打开 WebUI 页面进行对话测试。
小结
排查的核心逻辑在于:先修环境,再查服务,最后配路径。大部分无响应问题都源于环境变量未生效或 Ollama 接口不可达。按上述步骤逐项核对,通常能定位具体故障点。

