OpenClaw 2026.4.2 版本本地连接故障排查与修复指南
在升级至 OpenClaw 2026.4.2 版本后,原本运行正常的本地 AI 服务(如 Ollama 和 Omlx)出现了无法连接的情况。尽管外部网络访问保持正常,但指向本地 127.0.0.1 的 HTTP 请求被拦截,导致本地模型失效,仅云端模型可用。
01故障原因与定位
该问题的根本原因在于新版 OpenClaw 加强了 HTTP 安全策略,特别是针对 SSRF(服务端请求伪造)的防护。新版本默认阻止对本地私有网络(包括 localhost)的 HTTP 请求。即使这些请求来自受信任的本地服务,也会被策略拦截,从而引发 ollama_web_fetch 工具返回 404 错误以及 Omlx 对话功能失效。
02分步解决方案
- 验证本地服务状态
首先确认本地服务本身是否正常运行。可以通过 curl 命令检查 Ollama API,或使用 ps 命令检查 Omlx 进程状态,排除服务自身宕机的可能性。 - 检查当前安全配置
使用openclaw config get browser.ssrfPolicy查看当前配置。若配置缺失或未包含本地地址白名单,则确认为策略拦截所致。 - 配置 SSRF 策略白名单
通过修改配置文件或使用 API 命令,将 127.0.0.1 和 localhost 加入白名单,并开启dangerouslyAllowPrivateNetwork选项。 - 运行自动修复工具
执行openclaw doctor --fix,利用内置工具自动修正配置语法并备份旧配置。 - 重启服务与验证
重启 OpenClaw 网关后,再次调用本地 API 或使用 ollama_web_fetch 工具,确认连接恢复正常。
03配置参考与安全提示
完成修复后,系统即可在本地环境下流畅运行如 Gemma 4 等模型。以下为完整的配置参数参考,实施时需注意根据部署环境(开发或生产)调整安全策略强度。
| 配置对象 | 关键参数 | 推荐值/说明 |
|---|---|---|
| ssrfPolicy | dangerouslyAllowPrivateNetwork | true |
| ssrfPolicy | allowedHostnames | ["127.0.0.1", "localhost"] |
| Ollama Provider | baseUrl | http://127.0.0.1:11434 |
| Omlx Provider | baseUrl | http://127.0.0.1:8000/v1 |
| Tools | alsoAllow | ["ollama_web_search", "ollama_web_fetch"] |
OpenClaw 本地连接关键配置参数
在放宽本地网络限制的同时,需特别注意安全风险:此配置主要适用于个人或开发环境;生产环境应实施更严格的控制,并定期运行
openclaw security audit 进行安全审计,以防止引入不必要的风险。
当前文章无评论,是时候发表评论了