报错字典 / openclaw / ConnectionError

客户端连不上接入点

端点不可达，多半是代理或网络环境问题，不是 Agent 本身坏了。

原始报错

2026-11-05
ConnectionError: fetch failed / net::ERR_CONNECTION_REFUSED

原因

Agent 本身没问题，是它到接入点的这条路上断了：系统代理没被终端程序继承、端点域名在当前网络不可达、或者证书链不被信任。

解法

  1. 先用 curl 验证端点本身通不通：curl -I https://api.example.com/v1/models
  2. 检查系统代理是否配置，并在终端里显式导出 HTTPS_PROXY / HTTP_PROXY
  3. 看证书链，必要时把企业根证书装进系统信任库
  4. 仍然不通就换镜像线路，这也是整合包预置国内镜像的原因

同一工具的其他问题

npm EACCES装到一半权限被拒 openclaw