OpenClaw游戏列表刷新技巧分享

当OpenClaw游戏列表迟迟不显示新安装的游戏或内容陈旧，问题往往并非出在游戏本身，而是技能缓存未刷新、服务未重启、路径配置错误或元数据缺失所致；本文详解四步精准修复法：手动触发Skills页面重载、彻底清空并重启Gateway服务以重建索引、校准游戏技能至系统指定目录确保正确识别、最后验证并强制重载含type: game标识的SKILL.md配置——每一步直击核心机制，助你秒级恢复完整、实时、可交互的游戏列表。

如果您在OpenClaw中无法看到新安装的游戏或游戏列表显示陈旧，则可能是由于技能缓存未更新、本地路径未正确识别或Skills加载机制未触发重载。以下是刷新OpenClaw游戏列表的具体操作方法：

一、手动刷新Skills页面

该操作强制OpenClaw重新扫描当前工作区及全局Skills目录，识别新增或修改的游戏类技能（如game-launcher、steam-integration等），并更新可用游戏清单。

1、启动OpenClaw应用并进入主聊天界面。

2、点击左下角“完整功能UI”按钮，跳转至浏览器版Web控制面板。

3、在顶部导航栏选择“Skills”选项卡。

4、找到并点击页面右上角的“刷新”按钮（图标为循环箭头）。

5、等待页面提示“Skills已重新加载”，此时游戏列表将同步最新状态。

二、重启Gateway服务并清空运行时缓存

Gateway是OpenClaw的核心控制平面，其内存中会缓存Skills元数据；仅刷新UI无法清除已加载的旧索引，必须重启服务以重建游戏索引树。

1、打开终端（macOS/Linux）或命令提示符（Windows）。

2、执行命令：openclaw stop，确保Gateway进程已终止。

3、定位到OpenClaw工作区根目录，删除.cache/skills-index.json文件（若存在）。

4、执行命令：openclaw start，重新启动Gateway。

5、返回Web控制面板，再次进入Skills页面，确认游戏类技能已出现在列表中。

三、检查并校准游戏技能存放路径

OpenClaw按固定优先级加载Skills：工作区Skills > 全局Skills > 内置Skills。若游戏技能被误放至错误路径，将导致其无法被识别为可刷新项。

1、在OpenClaw聊天界面中输入指令：“告诉我游戏技能应该放在哪个文件夹？”。

2、记录系统返回的路径，例如：/Users/xxx/.openclaw/skills（macOS）或C:\Users\xxx\.openclaw\skills（Windows）。

3、打开该路径，确认其中包含以game-或launcher-开头的子文件夹（如game-epic、launcher-steam）。

4、若路径为空或结构不符，将游戏技能ZIP解压后的文件夹拖入该目录。

5、完成放置后，立即执行“刷新”操作（方法一）或重启Gateway（方法二）。

四、验证Skills配置文件完整性

每个游戏技能必须包含有效的SKILL.md文件，且其中需声明type: game或category: gaming字段，否则OpenClaw不会将其归类为“游戏”并纳入游戏列表。

1、进入对应游戏技能文件夹，打开SKILL.md文件。

2、检查文件头部是否存在如下YAML区块：

---
name: Steam Launcher
type: game
description: 启动Steam客户端并打开指定游戏
---

3、若缺失type字段或值不为game，手动添加并保存文件。

4、保存后，在终端中执行：openclaw skills reload --force。

5、观察终端输出是否包含“Loaded game skill: Steam Launcher”字样。

今天关于《OpenClaw游戏列表刷新技巧分享》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于openclaw的内容请关注golang学习网公众号！