跳转到主要内容

先区分三层设置

修改 Base URL 不会自动配置代理,模型连接成功也不代表 Agent 的工具具备网络权限。

从实际运行环境检查

在运行客户端的同一终端设置 APIONE_API_KEY,然后测试模型列表:
返回模型列表说明该进程的基本网络和认证可用。接着选择支持相应协议的模型测试推理请求。避免开启输出完整认证头的调试日志。

需要代理时

将示例端口替换为自己已运行的代理端口:
不同客户端和 HTTP 库对代理变量的支持不同。CLI 从新终端启动;桌面程序使用其网络设置或受支持的启动方式;Node.js 应结合当前版本和客户端文档检查代理行为。

容器与远程部署

  • 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 与认证头。
返回集成目录 · 模型选择 · 错误排查