若迁移后技能未加载或执行失败，需依次检查路径与格式、强制重导预设、手动重建并触发沉淀、验证配置开关、刷新技能索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成从 OpenClaw 到 Hermes Agent 的迁移，但发现原有技能未被加载或执行失败，则可能是由于技能文件路径变更、格式不兼容或未触发自动沉淀机制。以下是解决此问题的步骤：
一、验证技能文件是否已迁移至正确路径
Hermes Agent 仅从 ~/.hermes/skills/ 目录下加载技能文件，且要求为 Markdown 格式（.md 后缀）。OpenClaw 的技能若原存于其他位置（如 ~/.openclaw/presets/），不会被自动识别。
1、打开终端，执行命令查看技能目录是否存在及内容：
ls -la ~/.hermes/skills/
2、确认该目录下是否有对应技能文件，例如 analyze-csv-top-n.md 或 web-scrape-custom.md
3、若目录为空或缺失关键文件，需手动复制或重建技能文件
二、使用 hermes claw migrate --only presets 强制重导技能预设
该命令专用于迁移 OpenClaw 中定义的 Skills / Presets，跳过记忆与配置，避免干扰，适用于仅需恢复技能逻辑的场景。
1、在终端中运行预览命令，确认将被迁移的技能清单：
hermes claw migrate --dry-run --only presets
2、检查输出中是否列出预期的技能文件名（如 SOUL.md、web_search_preset.md）
3、确认无误后执行正式导入：
hermes claw migrate --only presets
三、手动重建技能文件并启用自动沉淀验证
Hermes Agent 支持从实际任务中自动提炼技能，前提是首次执行时使用标准工具链且未禁用 skill auto-save 功能。手动重建可绕过迁移遗漏，并触发后续自动优化。
1、在 ~/.hermes/skills/ 下新建文件，命名遵循小写短横线格式，例如：summarize-pdf-fast.md
2、按 Hermes 技能规范编写内容，首行必须为 YAML frontmatter，包含 name、description、parameters 字段
解决常见 OpenClaw 工作流瓶颈：平台 engage‑gates/429 回退辅助（始于 MoltX），标准化 JSON 结果封装用于脚本链式，工作区路径解析辅助，以及简易技能发布指挥（准备/发布/草稿公告）。
3、保存后，在交互模式中执行一次完整任务：
/skill summarize-pdf-fast --file report.pdf
4、任务完成后检查 ~/.hermes/skills/ 目录，确认同名文件被更新或新增 timestamp 注释
四、检查 config.yaml 中 skill 相关配置项
Hermes Agent 默认启用技能自动管理，但若 config.yaml 中存在显式禁用项，会导致技能加载失败。需确保核心开关处于开启状态。
1、使用文本编辑器打开 ~/.hermes/config.yaml
2、查找 skill.auto_save 字段，确认其值为 true
3、查找 skill.enabled 字段，确认其值为 true
4、若任一字段为 false，修改后保存，并重启 Agent：
hermes stop && hermes start
五、运行 hermes skill list 并强制刷新索引
即使技能文件存在，Hermes 可能因索引缓存未更新而无法识别。该命令可重建本地技能元数据映射表。
1、执行命令列出当前已识别技能：
hermes skill list
2、若输出为空或明显缺失，立即刷新索引：
hermes skill rebuild-index
3、再次运行 hermes skill list，确认此前缺失的技能已出现在列表中
4、对任一技能执行测试调用，例如：
hermes skill run analyze-csv-top-n --n 5 --file data.csv
