先区分三层设置
修改 Base URL 不会自动配置代理,模型连接成功也不代表 Agent 的工具具备网络权限。
从实际运行环境检查
在运行客户端的同一终端设置 APIONE_API_KEY,然后测试模型列表:需要代理时
将示例端口替换为自己已运行的代理端口:容器与远程部署
- Docker 内的 127.0.0.1 指向容器自身,不能直接代表宿主机代理。
- 云服务器上的 OpenClaw、Dify、Open WebUI 应从服务器侧排查网络。
- SSH 终端中的环境变量不会自动传给 systemd 或后台服务,需要在服务环境中单独配置并重启。
- 企业证书环境应安装可信 CA;不要用关闭 TLS 验证作为常规解决方案。
按错误定位
DNS 失败检查解析;连接超时检查出口和防火墙;TLS 错误检查证书链及系统时间;401 检查密钥;403 检查权限;404 检查协议与路径;429 检查额度及并发。 提交排障信息时附上客户端版本、时间、脱敏错误和 X-Maxx-Request-ID,隐藏 API Key 与认证头。返回集成目录 · 模型选择 · 错误排查

