修改AionClaw技能未生效最常见原因是OpenClaw未重载缓存或未扫描到SKILL.md：需确认文件名严格为SKILL.md、路径在~/.openclaw/workspace/skills/下，并用openclaw skills refresh刷新或重启网关清缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
修改AionClaw Skill后没有生效，最常见的情况是技能文件虽已保存，但OpenClaw进程仍在使用旧缓存的SKILL.md内容，或根本没重新扫描该目录——它不会自动监听文件变化，也不会在你保存后立刻重载元数据。
确认技能文件是否被正确识别
第一步：进入技能所在目录，执行ls -l检查文件名是否严格为SKILL.md（注意大小写和扩展名，skill.md、SKILL.MD、skill.md~都会被跳过）。
第二步：运行openclaw doctor --deep，重点看输出中“Skills scan result”部分是否列出你的技能名。如果完全没出现，说明OpenClaw压根没读到这个目录——此时不是修改没生效，而是技能根本没被加载。
第三步：检查目录路径是否在~/.openclaw/workspace/skills/下。AionClaw只扫描这个固定路径下的子目录，放错位置（比如放在~/skills/或~/.openclaw/skills/）会导致静默忽略。
强制刷新技能索引
方法一：重启网关并清空临时状态
执行openclaw gateway stop → 等待3秒 → 执行rm -rf /tmp/openclaw* → 再执行openclaw gateway start。这一步会清除所有运行时缓存，确保启动时重新扫描整个skills目录。
方法二：手动触发重扫描（不重启）
运行openclaw skills refresh。该命令会立即重新读取所有SKILL.md并更新内部索引表，适合快速验证修改效果。注意：它不会重启服务，也不影响当前对话流。
【必须等命令返回 success 后再测试，中途 Ctrl+C 会导致索引中断】
检查 description 是否触发失败
第一步：打开你的SKILL.md，定位到description:字段。
第二步：确认描述是否包含用户真实提问中的动词或名词。例如用户说“把这段文字转成小写”，而你的description写的是“字符串格式化工具”，就极难匹配；改成“将输入文本全部转为小写字母”才能稳定触发。
第三步：用openclaw logs --follow开一个实时日志窗口，然后在Web界面发起一次触发请求。如果日志里出现[skill] matched: your-skill-name，说明已识别；若只有[model] response received却无后续动作，问题出在模型返回的调用指令缺失，而非本地修改没生效。
