这页只做一件事：把“UI 异常”和“Skill 不生效”分开排查。两类问题混在一起时，最容易浪费时间。
本章完成标准
你读完后应该能在 2 分钟内判断是 Dashboard 层问题还是 Skill 层问题，并走对应命令流。
步骤一：先判断是哪一类故障
- Dashboard 层：页面打不开、状态不刷新、连接报错。
- Skill 层：页面正常，但指定 Skill 没触发或效果异常。
步骤二：如果是 Dashboard 层故障
openclaw gateway status
openclaw logs --follow
openclaw status再检查访问地址、端口占用、防火墙与当前 Gateway 绑定状态。
步骤三：如果是 Skill 层故障
openclaw skills list
openclaw skills list --eligible
openclaw skills info <skill_name>
openclaw status --deep
openclaw logs --follow重点确认：是否被同名覆盖、是否依赖缺失、是否旧会话快照未刷新。
步骤四：重开会话再复测
Skill 变更后旧会话可能仍使用旧快照。先新开会话再判断，不要在旧会话里反复试错。
高频误区
- 只看前端提示，不看 CLI 与日志。
- Skill 问题直接归因为模型问题。
- 未确认实际加载路径就修改了错误文件。