openclaw 安装报错
OpenClaw 常见错误中心：429 / 1008 / 网关失败
集中处理高频报错关键词，降低用户在安装与运行阶段的流失率。
1. 429 限流
429 多由上游模型配额或请求并发过高引起。
- 检查 API 额度与 RPM 限制
- 增加指数退避重试
- 降低并发并启用排队
2. 1008（需避免单一根因判断）
1008 是 WebSocket 策略/鉴权类关闭码，社区案例显示可能由多个因素触发。
- 网关 token 缺失或错误（unauthorized）
- pairing 状态未通过（channel/device）
- 协议帧或握手不匹配（社区已有相关 issue）
3. 统一排查流程
先定位层级（客户端/网关/上游），再逐步缩小范围。
- 复现问题并记录请求 ID
- 查看网关和应用日志时间线
- 做最小化请求验证修复是否生效
建议的故障抓取命令
docker compose ps\ndocker compose logs --since=30m openclaw-gateway\ncurl -i http://127.0.0.1:18789/healthz常见问题
为什么重启后又报错？
多半是根因未修复，只是临时恢复。建议做配置基线和监控告警。
如何给社区提 issue 才高效？
附上版本、日志片段、复现步骤和最小配置。