技术支持
如果你在使用 ClawPilot 时遇到问题，请通过以下方式联系我们：
建议反馈内容
- App 版本号
- iOS 版本号
- 问题出现时间
- 复现步骤（尽量详细）
- 相关截图（如有）
常见问题
1. App 无法连接 Gateway
- 请先确认 Gateway 地址可访问。
- 检查当前 Gateway 地址是否为
wss://（生产环境建议使用wss，不建议公网使用ws）。 - 检查配对码是否已过期。
- 检查网络环境是否拦截 WebSocket。
- 若使用
wss，请确认网关证书有效且域名匹配，避免握手失败。 - 若更换过网关域名或端口，建议在 App 中删除旧网关配置后重新添加。
2. 无法收到推送通知
- 先在 ClawPilot 的设置页中手动触发通知相关设置，确认应用内通知配置已开启。
- 检查 iOS 系统设置中 ClawPilot 的通知权限是否允许（横幅、声音、角标）。
- 检查设备是否处于勿扰模式、专注模式或低电量模式，这些状态可能影响通知展示。
- 若你刚完成设备配对或修改过通知相关配置，建议等待约 1 分钟后再测试一次。
3. OpenClaw 修改设置后不生效
- 部分配置仅在 Gateway 重启后生效，修改后建议重启 OpenClaw Gateway。
- 确认你修改的是当前正在连接的同一个 Gateway 实例（避免改错环境）。
- 若你调整了模型、工具或权限配置，建议新建会话后再测试，避免受旧会话上下文影响。
- 仍未生效时，可在 App 中断开并重新连接网关，再重新发起测试请求。
4. Gateway 配对失败或提示 pairing_required / unauthorized
- 请先在 Gateway 侧完成设备审批，确认该设备请求已被允许。
- 若配对码有时效限制，请重新生成最新配对码后再尝试。
- 确认 App 中填写的 Gateway 地址与实际部署地址一致（协议、域名、端口都需一致）。
- 若同一设备多次配对失败，建议删除旧网关配置后重新配对一次。
5. 消息发送后一直转圈，或回复中途中断
- 检查 Gateway 服务是否仍在线（可先在 Gateway 端确认服务进程状态）。
- 检查你接入的模型服务是否可用（例如 API Key、额度、区域网络限制）。
- 检查当前网络是否存在 WebSocket 长连接中断（公司网络/代理环境较常见）。
- 建议先切换到新会话再发一条简短消息做最小化测试，确认是否为单会话问题。
6. 会话列表或历史消息看起来不完整
- 在会话抽屉中手动下拉刷新，等待历史回拉完成。
- 切换到其他会话后再切回目标会话，触发重新加载。
- 确认你当前连接的是同一个 Gateway 实例，避免连接到错误环境导致“历史不一致”。
- 若刚重置过会话或执行过清理操作，请以 Gateway 侧会话状态为准重新验证。
7. App 更新后出现连接异常
- 先完全退出 App 后重启，再重新连接当前 Gateway。
- 确认 App 版本与 Gateway 版本兼容，必要时同时升级 Gateway 到较新版本。
- 若升级后仍异常，建议删除并重新添加该 Gateway 配置。
- 反馈问题时请附上 App 版本、Gateway 版本与具体报错文案，便于快速定位。