为什么错误排查也要先看来源
很多连接问题看起来像软件故障，实际可能是安装来源、模型服务、账号权限、额度、代理或端口占用造成的。如果来源本身不可验证，后面的错误码解释也会变得不可靠。
因此这次更新把连接排查 guide 的重点提前：不要先重装，不要先换脚本，也不要把所有错误都归因于 OpeClaw。先确认下载页、系统平台、模型服务和配置记录。
建议先记录这些信息
- 错误原文：例如 401、429、EADDRINUSE、token 缺失或回复中断。
- 系统环境：Windows、macOS 或 Linux，以及是否使用代理或公司网络。
- 安装来源：是否来自当前下载页与可验证说明。
- 模型服务：API、额度、权限和请求频率是否正常。
- 最近改动：密钥、端口、权限、启动方式或配置文件是否刚调整过。
这次内容更新覆盖哪些页面
本站已把 OpeClaw 连接排查 guide 作为主要入口，并在下载状态、FAQ 和 News 中强调同一件事：错误排查不是猜命令，而是按证据缩小范围。
如果你看到 token、额度或权限提示，先不要把密钥贴到公开页面，也不要反复重试。把错误原文、模型服务和本机配置记录下来，再按 guide 排查。
连接与错误排查常见问题
OpeClaw 登录失败一定是软件坏了吗？
不一定。登录失败可能和账号状态、模型服务权限、网络环境、来源不一致或本机配置有关，建议先按检查顺序排查。
HTTP 429 应该马上重试吗？
不建议反复重试。429 往往和请求频率、额度或服务限制有关，先暂停请求并核对模型服务后台更稳妥。
gateway token missing 要怎么处理？
本站不提供未验证命令。遇到 token 类提示时，应先确认配置来源、密钥保存位置、环境变量和当前项目说明。