什么值得买App下载 App ›
连续签到专享现金活动

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分步解决方案
  1. 验证本地服务状态
    首先确认本地服务本身是否正常运行。可以通过 curl 命令检查 Ollama API,或使用 ps 命令检查 Omlx 进程状态,排除服务自身宕机的可能性。
  2. 检查当前安全配置
    使用 openclaw config get browser.ssrfPolicy 查看当前配置。若配置缺失或未包含本地地址白名单,则确认为策略拦截所致。
  3. 配置 SSRF 策略白名单
    通过修改配置文件或使用 API 命令,将 127.0.0.1 和 localhost 加入白名单,并开启 dangerouslyAllowPrivateNetwork 选项。
  4. 运行自动修复工具
    执行 openclaw doctor --fix,利用内置工具自动修正配置语法并备份旧配置。
  5. 重启服务与验证
    重启 OpenClaw 网关后,再次调用本地 API 或使用 ollama_web_fetch 工具,确认连接恢复正常。
03配置参考与安全提示
完成修复后,系统即可在本地环境下流畅运行如 Gemma 4 等模型。以下为完整的配置参数参考,实施时需注意根据部署环境(开发或生产)调整安全策略强度。
配置对象关键参数推荐值/说明
ssrfPolicydangerouslyAllowPrivateNetworktrue
ssrfPolicyallowedHostnames["127.0.0.1", "localhost"]
Ollama ProviderbaseUrlhttp://127.0.0.1:11434
Omlx ProviderbaseUrlhttp://127.0.0.1:8000/v1
ToolsalsoAllow["ollama_web_search", "ollama_web_fetch"]

OpenClaw 本地连接关键配置参数

在放宽本地网络限制的同时,需特别注意安全风险:此配置主要适用于个人或开发环境;生产环境应实施更严格的控制,并定期运行 openclaw security audit 进行安全审计,以防止引入不必要的风险。

评论

评论区空态插画

当前文章无评论,是时候发表评论了