HermesAgent迁移后技能丢失解决方法

当从OpenClaw迁移至Hermes Agent后出现技能丢失或执行失败，别担心——这通常源于路径变更、格式不兼容或索引未刷新等常见问题；只需五步精准排查：确认技能文件已正确移入~/.hermes/skills/并保存为Markdown格式，用hermes claw migrate --only presets强制重导预设，手动创建规范技能文件并执行一次任务触发自动沉淀，检查config.yaml中skill.auto_save和skill.enabled是否均为true，最后运行hermes skill rebuild-index彻底刷新索引——轻松找回所有技能，让智能体能力无缝延续。

如果您已完成从 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 字段

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

今天关于《HermesAgent迁移后技能丢失解决方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！