若openclaw web界面未显示已安装技能，需依次执行：一、强制刷新并清除浏览器缓存；二、重启gateway进程；三、检查skills目录结构及skill.md、manifest.json文件完整性；四、手动触发skills重扫描；五、查看gateway日志确认加载状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装 OpenClaw Skills，但在 Web 界面中未显示该技能，且 Gateway 无响应或技能列表为空，则很可能是界面缓存未更新或后台服务未正确加载技能元数据。以下是解决此问题的步骤：
一、强制刷新 OpenClaw Web 界面并清空浏览器缓存
浏览器本地缓存可能保留旧版技能列表或静态资源，导致新安装的 Skill 不被渲染。需彻底清除与 OpenClaw 相关的页面数据。
1、在 OpenClaw Web 界面（通常为 http://localhost:18789）中，按 Ctrl + Shift + R（Windows/Linux）或 Cmd + Shift + R（macOS）执行硬性重载。
2、打开浏览器开发者工具（F12），切换到 Application 标签页，点击左侧 Clear storage，勾选 Cache storage 和 Service Workers，点击 Clear site data。
3、关闭所有含 OpenClaw 的浏览器标签页，重新打开并访问地址。
二、重启 OpenClaw Gateway 进程
Gateway 是技能注册与路由的核心服务，若其未检测到新技能目录变更或未完成热重载，技能将无法出现在 UI 中。手动重启可触发完整初始化流程。
1、在终端中执行命令停止当前 Gateway：openclaw gateway stop。
2、确认进程已退出：运行 ps aux | grep gateway，确保无 openclaw-gateway 进程残留。
3、重新启动 Gateway：openclaw gateway start。
4、等待约 5–8 秒后，刷新 Web 界面查看技能是否出现。
三、检查 Skills 目录结构与文件完整性
OpenClaw 仅识别符合严格目录规范的 Skill，任意层级缺失或命名错误均会导致静默跳过，不报错也不显示。
1、确认 Skill 安装路径为：~/.claude/skills/
监控 OpenClaw GitHub 版本更新，获取最新版本发布说明，翻译成中文， 并推送到 Telegram 和 Feishu。用于：(1) 定时检查版本更新 (2) 推送版本更新通知 (3) 生成中文版发布说明
2、进入该目录，运行命令验证必需文件存在：ls skill.md manifest.json（macOS/Linux）或 dir skill.md manifest.json（Windows）。
3、若 skill.md 缺失，创建空文件并保存；若 manifest.json 内容为空或格式非法，需按官方 Schema 补全 name、version、entry 字段。
四、手动触发 Skills 重扫描
Gateway 默认监听文件系统事件，但某些部署环境（如 Docker 挂载、WSL2 文件系统延迟、IDE 同步工具干扰）可能导致 inotify 失效，需主动通知服务重新索引。
1、在终端中切换至 OpenClaw 主目录（通常为 ~/.openclaw 或安装路径）。
2、执行重扫描命令：openclaw skills rescan。
3、观察终端输出是否包含类似 Found 1 new skill:
4、若输出 No skills found，说明目录路径或权限异常，需返回第三步核查。
五、验证 Gateway 日志中技能加载状态
日志是判断技能是否被识别的直接依据，Gateway 启动及扫描过程会逐条打印加载结果，可据此定位静默失败原因。
1、执行命令实时查看日志：openclaw gateway logs --tail 50。
2、在日志末尾查找关键词：loading skill、registered skill 或 skip invalid skill。
3、若出现 skip invalid skill: missing skill.md，立即补全该文件；若出现 permission denied on ~/.claude/skills，需修复目录所有权（macOS/Linux 执行 chmod -R 755 ~/.claude/skills）。
