【Hermes：Skill系统深度】22、资产保值时代：OpenClaw Skill → Hermes 无缝迁移完整指南

资产保值时代：OpenClaw Skill → Hermes 无缝迁移完整指南

摘要：Agent Skills 已成为 AI 能力的标准化载体，截至 2026 年初，公开可用的 Agent Skills 已超过 85,000 个，支持该标准的主流平台达 27 家。如果你已经在 OpenClaw 上积累了丰富的 Skill 资产，迁移到 Hermes Agent 是否意味着一切推倒重来？答案恰恰相反。本文基于 agentskills.io 开放标准，手把手演示从 OpenClaw 到 Hermes 的完整迁移流程------从一键自动迁移到手工精细适配，从 SOUL.md 规则转换到工具名与 MCP 接口映射，甚至逆向后将 Hermes 自创 Skill 放回 OpenClaw 复用。核心结论：遵循开放标准的 Skill 不绑定平台，你的资产比想象中更保值。全文包含多张 Mermaid 流程图、代码示例和对比表格，助你在 30 分钟内完成无缝切换。

一、为什么 Skill 资产不绑定平台？

1.1 Agent Skills：AI 时代的"Dockerfile"

2025 年 12 月 18 日，Anthropic 联合多家生态伙伴在 agentskills.io 正式开源 Agent Skills Specification V1.0 ，将 Claude Skills 中验证有效的经验正式标准化。该规范被 TechCrunch 称为 "AI 领域的 Dockerfile"------它让 AI 能力变得可移植、可组合、可版本控制。

截至 2026 年 2 月初，全球公开可用的 Agent Skills 已超过 85,000 个，微软 Azure AI Studio、GitHub Copilot Workspace、Cursor 等 27 家主流平台均已宣布支持该标准。Linux 基金会也已启动讨论，拟将 Agent Skills 纳入其 AI & Data 基金会（AIDF）的候选标准之一。
你的 Skill 资产
支持平台（27+家）
开放标准层
agentskills.io

Agent Skills Specification
Hermes Agent
OpenClaw
Claude Code
Cursor
VS Code Copilot
Azure AI Studio
...
SKILL.md

脚本/资源

这意味着什么？ 你为 OpenClaw 编写的 Skill，只要遵循 agentskills.io 标准，就可以直接在 Hermes 中使用，无需任何修改。Hermes 严格遵循 Agent Skills 开放标准，与 agentskills.io 生态 100% 兼容。反之亦然------Hermes 自动生成的 Skill 也可以在 Claude Code、Cursor 等工具中直接复用。

1.2 Hermes 与 OpenClaw 的生态定位

在深入迁移操作之前，有必要厘清两者的关系。OpenClaw 是一个围绕中央控制平面（Gateway）组织的 AI 执行中枢，主打跨平台、多入口、全场景任务执行。Hermes Agent 则把 Agent 自身的执行循环作为核心------一个可重复的 "执行-学习-改进"周期，Agent 在完成复杂任务后能自主创建技能，并在使用过程中持续优化。

如果用一句话区分：OpenClaw 解决"工作区和上下文怎么组织"，Hermes 解决"agent 怎么长期运行、跨平台接入和对外服务" 。两者不是对立关系，而是不同层次的互补。Hermes Agent 直接内置了从 OpenClaw 迁移的工具 hermes claw migrate，说明 Hermes 是 OpenClaw 的精神继承者和升级版。

下表从 Skill 维度对比两者的核心差异：

维度	OpenClaw Skill	Hermes Skill
创建方式	人工编写，手动维护	自动生成 + 手动编写，支持自改进
更新机制	静态，需人工修改	动态，基于执行反馈自动更新
技能来源	人工定义	Agent 从任务经验中"生长"出来
开放标准	兼容 agentskills.io	严格遵循 agentskills.io
Skill 数量	内置 + 社区（万级规模）	74 内置 + 44 可选 + 521 社区
生命周期	手动管理	闭环学习：执行→反馈→优化→沉淀

两者共同的基石是 agentskills.io 开放标准。OpenClaw 实现了 AgentSkills.io 规范，使用目录化的 Skill 文件夹来教智能体使用工具。Hermes 同样遵循该标准，这使得双向迁移在技术上完全可行。
Hermes 生态
agentskills.io

开放标准桥梁
OpenClaw 生态
一键迁移
逆向复用
人工编写 Skill
Skill 目录

skill.yaml + SKILL.md
万级社区 Skill
统一格式

YAML frontmatter

Markdown 指令
自动生成 Skill

从任务中学习
Skill 自进化

反馈驱动优化
74+44+521

内置+社区 Skill

1.3 迁移的核心价值

迁移不是"换工具"，而是资产的升级与保值：

✅ 资产零损失：OpenClaw 中的 Skill、记忆、配置、API 密钥、消息平台配置均可一键导入，基本实现无缝切换
✅ 能力升级：迁移后，原有的静态 Skill 可以获得 Hermes 的自进化和跨会话记忆能力
✅ 生态扩展：同一份 Skill 可以在 11+ 其他采用 agentskills.io 规范的工具中工作
✅ 双向自由：Hermes 自动创建的 Skill 同样可以放回 OpenClaw 复用

二、迁移全流程概览

Hermes Agent 提供了从一键自动迁移到手工精细适配的完整迁移路径。整个迁移的核心路径是：安装 Hermes → hermes claw migrate 一键导入 → 配置模型端点 → 重绑渠道，全过程通常在 30 分钟内完成。
推荐方式
精细控制
特殊场景
SOUL.md 规则
工具名映射
MCP 接口
消息渠道
迁移前准备

备份 OpenClaw 数据
选择迁移方式
一键自动迁移

hermes claw migrate
命令行精细迁移

--only / --exclude 参数
手工映射迁移

处理硬编码路径/废弃接口
验证迁移结果
需要额外适配？
合并至 Hermes

~/.hermes/SOUL.md
适配工具名

clawdbot.utils → hermes.skills
调整 MCP 配置
消息通道重绑定
测试验证

Skill 行为校验
迁移完成 ✅

资产保值，能力升级

三、迁移步骤详解

3.1 迁移前准备：备份与验证

在开始任何迁移操作前，建议手动备份 OpenClaw 的配置和记忆目录：

bash 复制代码

# 备份 OpenClaw 配置（路径以实际安装位置为准）
cp -r ~/.openclaw ~/.openclaw_backup_$(date +%Y%m%d)

确认 Hermes 环境要求（Python ≥ 3.10，Linux / macOS / WSL2 支持）。若尚未安装 Hermes，执行：

bash 复制代码

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc  # 或 source ~/.zshrc
hermes --version  # 验证安装，预期输出 hermes v0.8.0

3.2 方式一：一键自动迁移（推荐）

Hermes Agent 安装程序会自动检测 OpenClaw 存在并启动交互式导入，适用于默认安装路径（~/.openclaw）且未手动修改过核心目录结构的用户。

bash 复制代码

# 运行初始化向导
hermes setup

# 当提示 "Detected existing OpenClaw configuration at ~/.openclaw. Import it? [Y/n]:" 时
# 输入 Y 并回车
# 等待终端输出 "Migration completed successfully"

迁移内容包括：

配置文件（模型设置、工具权限、渠道绑定）
持久记忆（历史会话摘要、用户偏好）
技能预设（已安装的 Skills / Presets）

一键自动迁移流程
是
否
Y
hermes setup
检测到 OpenClaw?
提示导入确认
正常初始化
自动导入
配置
记忆
技能
完成 ✅

3.3 方式二：命令行精细迁移（按需选择）

该方式通过显式调用 hermes claw migrate 子命令控制迁移粒度，适用于需排除敏感密钥、跳过特定技能或处理非标准 OpenClaw 路径的场景。所有操作均只读取源文件并写入新位置，不删除、不覆盖 ~/.openclaw 中任何原始内容。

bash 复制代码

# 预览待迁移项（干运行模式，不实际执行）
hermes claw migrate --dry-run

# 仅迁移技能预设（跳过记忆与密钥）
hermes claw migrate --only presets

# 迁移全部内容但排除 Telegram 配置
hermes claw migrate --exclude messaging.telegram

# 指定非默认 OpenClaw 路径
hermes claw migrate --source /opt/claw-data

干运行模式输出示例：

复制代码

[DRY RUN] Would copy: skills/backup-tool/ → ~/.hermes/skills/openclaw-imports/backup-tool/
[DRY RUN] Would copy: skills/pdf-processor/ → ~/.hermes/skills/openclaw-imports/pdf-processor/
[DRY RUN] Would copy: memories/* → ~/.hermes/memories/

3.4 方式三：手工映射迁移（结构适配）

适用于 OpenClaw 技能依赖特定路径硬编码、含相对导入语句或使用了已被 Hermes 废弃的钩子接口的特殊情况。

bash 复制代码

# 1. 复制技能目录
cp -r ~/.openclaw/skills/* ~/.hermes/skills/

# 2. 检查每个技能目录下的 SKILL.md 文件
# Hermes v0.8+ 要求 YAML frontmatter 格式规范

# 3. 合并 SOUL.md（详见第四节）
cat ~/.openclaw/SOUL.md >> ~/.hermes/SOUL.md

# 4. 迁移记忆文件
cp ~/.openclaw/MEMORY.md ~/.hermes/memory/
cp ~/.openclaw/USER.md ~/.hermes/

四、SOUL.md 规则迁移方法

4.1 SOUL.md 的本质

OpenClaw 使用 SOUL.md 来定义 Agent 的人格声明、行为准则和系统提示词。每个 Agent 拥有独立的 workspace，通过 SOUL.md 文件进行身份和行为定义。Hermes 同样支持 SOUL.md，但格式和内容组织略有不同。

4.2 迁移步骤

bash 复制代码

# 1. 复制 SOUL.md 内容
cat ~/.openclaw/SOUL.md >> ~/.hermes/SOUL.md

# 2. 删除 OpenClaw 特有的配置分隔块
# 保留首段人格声明，删除末尾 "--- CLAWDBOT CONFIG ---" 分隔块及之后的内容

4.3 格式适配对比

内容类型	OpenClaw SOUL.md	Hermes SOUL.md
人格声明	任意 Markdown	任意 Markdown（兼容）
行为规则	内嵌于文档	内嵌于文档（兼容）
配置分隔	`--- CLAWDBOT CONFIG ---`	不需要，由 config.yaml 管理
记忆日志	`## Skill Execution Log` 区块	移至 `~/.hermes/memory/EXECUTION_LOG.md`

迁移后 - Hermes
迁移前 - OpenClaw
删除
人格声明
行为规则
--- CLAWDBOT CONFIG ---
技能执行日志
人格声明
行为规则
~/.hermes/memory/

EXECUTION_LOG.md
忽略

五、工具名与 MCP 适配

5.1 Python 导入路径映射

OpenClaw 技能中常见的 import clawdbot.utils 需要替换为 Hermes 兼容格式：

python 复制代码

# OpenClaw 风格（迁移前）
from clawdbot.utils import file_helper, config_loader

# Hermes 风格（迁移后）
from hermes.skills import utils
# 或根据具体技能结构调整导入路径

5.2 工具名对照表

功能类型	OpenClaw 调用方式	Hermes 调用方式
文件操作	`clawdbot.file.read()`	`hermes.tools.file.read()`
命令执行	`clawdbot.shell.run()`	`hermes.tools.shell.exec()`
HTTP 请求	`clawdbot.http.get()`	`hermes.tools.http.request()`
消息推送	`clawdbot.message.send()`	`hermes.gateway.send()`

5.3 MCP（Model Context Protocol）适配

Hermes 和 OpenClaw 都支持 MCP 协议，迁移时无需修改 MCP 服务端配置，只需在 ~/.hermes/config.yaml 中重新声明 MCP 服务：

yaml 复制代码

# ~/.hermes/config.yaml
mcp:
  enabled: true
  servers:
    - name: "filesystem"
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
    - name: "github"
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-github"]

5.4 消息通道重绑定

迁移后，Telegram、Discord、Slack 等消息平台的配置需要重新绑定。Hermes 提供了便捷的重绑定方式：

bash 复制代码

# 重新配置消息平台
hermes gateway setup

# 或在 config.yaml 中重新配置各平台凭证

迁移工具会自动提取 OpenClaw 中的 API 密钥与消息网关配置，但你仍需确认目标频道的权限设置。

六、双向迁移：Hermes Skill 放回 OpenClaw

6.1 逆向迁移的价值

Hermes 的核心特性之一是 Agent 在完成复杂任务后自动创建 SKILL.md 文件，将成功的方法提取为可复用的技能。这意味着 Hermes 可以帮你"生长"出原本需要大量人工编写才能获得的 Skill。而这些 Skill 遵循 agentskills.io 开放标准，完全可以放回 OpenClaw 中使用。
双向复用
Hermes 自动生成 Skill
执行复杂任务
分析成功路径
自动写入 SKILL.md
遵循 agentskills.io 标准
OpenClaw 加载
Claude Code 加载
Cursor 加载
其他兼容工具加载

6.2 逆向迁移操作步骤

bash 复制代码

# 1. 将 Hermes 生成的 Skill 复制到 OpenClaw 技能目录
cp -r ~/.hermes/memories/skills/* ~/.openclaw/skills/

# 2. 检查 Skill 格式是否符合 OpenClaw 的解析要求
# OpenClaw 的解析器要求 frontmatter 值使用单行格式
# Hermes 生成的 Skill 默认为多行格式，需手动调整为单行

# 3. 验证 Skill 在 OpenClaw 中可用
openclaw skills list  # 应显示导入的 Skill

6.3 格式兼容性处理

Hermes 和 OpenClaw 虽然都遵循 agentskills.io 标准，但在解析细节上存在差异：

差异点	Hermes	OpenClaw
frontmatter 格式	支持多行值	要求单行值
扩展字段	`metadata.*`	`metadata.openclaw.*`
依赖声明	`requires` 字段	`metadata.openclaw.requires` 对象
安装脚本	不强制要求	支持 `metadata.openclaw.install` 数组

逆向迁移时需要对这些差异进行适配，确保 Skill 在两个平台上都能正常工作。

七、实战案例：PDF 分析 Skill 完整迁移演示

7.1 案例背景

假设我们在 OpenClaw 中有一个名为 pdf-analyzer 的 Skill，功能是：提取 PDF 文本并生成摘要。现在要将其迁移到 Hermes，并验证迁移后功能是否正常。

7.2 迁移前：OpenClaw Skill 结构

复制代码

~/.openclaw/skills/pdf-analyzer/
├── SKILL.md
├── scripts/
│   └── extract.py
└── references/
    └── api_docs.md

SKILL.md 内容（简化）：

markdown 复制代码

---
name: pdf-analyzer
description: Extract text from PDF files and generate summary
metadata:
  openclaw:
    requires:
      bins: ["pdftotext", "python3"]
---

# PDF Analyzer Skill

## Description
This skill extracts text content from PDF files and generates an AI summary.

## Execution
1. Run `pdftotext {file} -` to extract text
2. Pass extracted text to LLM for summarization

7.3 执行迁移

bash 复制代码

# 执行一键迁移
hermes claw migrate

# 迁移后，Skill 被复制到
# ~/.hermes/skills/openclaw-imports/pdf-analyzer/

7.4 迁移后验证与微调

bash 复制代码

# 1. 验证 Skill 是否被 Hermes 识别
hermes skills list | grep pdf-analyzer

# 2. 测试 Skill 功能
hermes run "使用 pdf-analyzer 分析 document.pdf 并生成摘要"

# 3. 如遇问题，检查依赖是否满足
# pdftotext 命令在 Hermes 环境中是否可用？
which pdftotext  # 若不存在，需安装 poppler-utils

7.5 迁移后能力升级

迁移到 Hermes 后，原有的静态 Skill 将获得以下增强：

自改进能力：每次执行后，Hermes 会根据用户反馈和错误日志自动优化 Skill 的执行流程
跨会话记忆：执行记录会被保存到记忆系统，后续类似任务可直接复用
多平台调用：可通过 Telegram、Discord 等任意支持的消息平台调用该 Skill
Skill 版本管理：自动记录版本变更，支持回滚

迁移后 - Hermes
迁移前 - OpenClaw
人工编写 Skill
静态执行流程
无自改进
仅限 OpenClaw 调用
继承原 Skill 功能
✅ 自改进能力

反馈驱动优化
✅ 跨会话记忆

经验复用
✅ 多平台调用

Telegram/Discord/CLI
✅ 版本管理

自动记录+回滚

八、资产保值：Skill 不绑定平台

8.1 开放标准的意义

Agent Skills 开放标准的诞生，正是为了解决 AI 助手技能开发碎片化、跨平台不兼容、复用性低的行业痛点。该标准通过结构化目录、统一接口定义与元数据声明，实现跨平台、跨框架的能力共享。

对于开发者而言，这意味着：

一次编写，多处运行：Skill 可在 Hermes、OpenClaw、Claude Code、Cursor、VS Code Copilot 等 27+ 主流平台间共享
资产保值：平台更迭时，Skill 资产不贬值，只需少量适配即可继续使用
生态红利：可以复用社区 85,000+ 个公开 Skill，大幅降低重复开发成本

8.2 Hermes 迁移后的能力跃迁

迁移不仅仅是"换个地方运行"，更是一次能力的全面升级：

能力维度	迁移前（OpenClaw）	迁移后（Hermes）
Skill 创建	人工编写	自动生成 + 人工编写
Skill 维护	手动修改	自动优化（反馈驱动）
记忆能力	有限	FTS5 全文检索 + 用户建模
跨会话上下文	需手动管理	自动持久化
技能分享	私有的 skill.yaml 格式	agentskills.io 开放标准
学习循环	无	闭环学习系统
模型选择	有限	200+ 模型随时切换

迁移的价值跃迁
hermes claw migrate
能力跃迁维度
📈 效率：Skill 自动生成

无需人工编写框架代码
🔄 质量：自改进优化

越用越精准
🌐 生态：跨平台复用

一次构建多处运行
🧠 记忆：跨会话上下文

AI 真正"记住"你
OpenClaw Skill

人工编写·静态·私有格式
Hermes Skill

自动生成·自进化·开放标准

8.3 资产保值的三大支柱

标准兼容：agentskills.io 开放标准确保了 Skill 格式的通用性，不依赖特定平台的私有格式
双向迁移：Hermes 不仅可以从 OpenClaw 导入，其自动生成的 Skill 也可以导出到 OpenClaw 及其他兼容平台
渐进升级：迁移不是"一刀切"，可以逐步将核心 Skill 迁移到 Hermes，享受自进化红利，同时保留部分 Skill 在 OpenClaw 中运行

九、常见问题与解决方案

Q1：迁移后 Skill 未被加载

排查步骤：

bash 复制代码

# 1. 验证技能文件是否已迁移至正确路径
ls ~/.hermes/skills/

# 2. 检查 Hermes 是否识别了该 Skill
hermes skills list | grep <skill-name>

# 3. 查看加载日志
hermes gateway logs --tail 20

Q2：OpenClaw 中的硬编码路径失效

Hermes 的目录结构与 OpenClaw 不同。解决方案：

将相对路径改为基于 ~/.hermes/ 的绝对路径
或使用环境变量注入（如 $HERMES_HOME）

Q3：SOUL.md 中的执行日志丢失

Hermes 将技能执行日志存储在不同位置：

bash 复制代码

# 将 OpenClaw 的 MEMORY.md 中以 ## Skill Execution Log 开头的区块
# 剪切至 Hermes 的 ~/.hermes/memory/EXECUTION_LOG.md 新建文件

Q4：Python 导入报错 `ModuleNotFoundError: No module named 'clawdbot'`

bash 复制代码

# 批量替换技能文件中的导入语句
find ~/.hermes/skills -name "*.py" -exec sed -i 's/clawdbot\./hermes\.skills\./g' {} \;

Q5：迁移后飞书/钉钉等国内渠道无法使用

Hermes 原生支持 14+ 消息平台，包括 CLI、Telegram、Discord、Slack、WhatsApp、Signal、Email 等。对于飞书、钉钉、企业微信等国内平台，可参考官方文档进行渠道扩展配置。

十、总结：零成本复用原有资产

10.1 核心要点回顾

OpenClaw → Hermes

迁移核心要点
标准基础
agentskills.io 开放标准
27+ 平台支持
85,000+ 公开 Skill
迁移方式
一键自动迁移（推荐）
命令行精细迁移
手工映射适配
适配内容
SOUL.md 规则合并
工具名与 MCP 映射
消息通道重绑定
资产升级
自改进能力加持
跨会话记忆增强
多平台调用扩展
双向复用
Hermes Skill → OpenClaw
一次编写多处运行

10.2 迁移决策流程图

否
是
是
否
小规模
大规模
是否有 OpenClaw

Skill 资产？
直接使用 Hermes

从零创建 Skill
Skill 格式

是否兼容 agentskills.io？
✅ 一键迁移

hermes claw migrate

资产零损失
迁移规模
手工映射迁移

逐 Skill 适配
先标准化 Skill 格式

再执行一键迁移
获得自进化的能力升级
资产升级保值 ✅

10.3 行动清单

步骤	操作	预计耗时
1	备份 OpenClaw 数据	1 分钟
2	安装 Hermes Agent	2 分钟
3	执行 `hermes claw migrate`	2 分钟
4	合并 SOUL.md 规则	5 分钟
5	适配工具名与 MCP 配置	10 分钟
6	重绑消息渠道	5 分钟
7	测试验证	5 分钟
总计		约 30 分钟

10.4 一句话总结

遵循 agentskills.io 开放标准的 Skill 是你在 AI 时代最保值的资产，从 OpenClaw 到 Hermes 的迁移不是"推倒重来"，而是资产升级与能力跃迁。

本文由 Hermes 社区贡献者编写，遵循 CC BY-NC 4.0 协议。

相关阅读：

[从人工指令到自动进化：Hermes Skill 系统原理与实战全解析](#从人工指令到自动进化：Hermes Skill 系统原理与实战全解析)（系列第8篇）
[从零写一个 Hermes Skill：结构、触发、规则、示例](#从零写一个 Hermes Skill：结构、触发、规则、示例)（系列第20篇）
[一个大脑多端说话：Hermes 跨平台会话连续性深度解析](#一个大脑多端说话：Hermes 跨平台会话连续性深度解析)（系列第18篇）
[离线也能用的最强AI：Ollama + Hermes 本地部署完全指南](#离线也能用的最强AI：Ollama + Hermes 本地部署完全指南)（系列第14篇）

【Hermes：Skill系统深度】22、资产保值时代：OpenClaw Skill → Hermes 无缝迁移完整指南

资产保值时代：OpenClaw Skill → Hermes 无缝迁移完整指南

一、为什么 Skill 资产不绑定平台？

1.1 Agent Skills：AI 时代的"Dockerfile"

1.2 Hermes 与 OpenClaw 的生态定位

1.3 迁移的核心价值

二、迁移全流程概览

三、迁移步骤详解

3.1 迁移前准备：备份与验证

3.2 方式一：一键自动迁移（推荐）

3.3 方式二：命令行精细迁移（按需选择）

3.4 方式三：手工映射迁移（结构适配）

四、SOUL.md 规则迁移方法

4.1 SOUL.md 的本质

4.2 迁移步骤

4.3 格式适配对比

五、工具名与 MCP 适配

5.1 Python 导入路径映射

5.2 工具名对照表

5.3 MCP（Model Context Protocol）适配

5.4 消息通道重绑定

六、双向迁移：Hermes Skill 放回 OpenClaw

6.1 逆向迁移的价值

6.2 逆向迁移操作步骤

6.3 格式兼容性处理

七、实战案例：PDF 分析 Skill 完整迁移演示

7.1 案例背景

7.2 迁移前：OpenClaw Skill 结构

7.3 执行迁移

7.4 迁移后验证与微调

7.5 迁移后能力升级

八、资产保值：Skill 不绑定平台

8.1 开放标准的意义

8.2 Hermes 迁移后的能力跃迁

8.3 资产保值的三大支柱

九、常见问题与解决方案

Q1：迁移后 Skill 未被加载

Q2：OpenClaw 中的硬编码路径失效

Q3：SOUL.md 中的执行日志丢失

Q4：Python 导入报错 ModuleNotFoundError: No module named 'clawdbot'

Q5：迁移后飞书/钉钉等国内渠道无法使用

十、总结：零成本复用原有资产

10.1 核心要点回顾

10.2 迁移决策流程图

10.3 行动清单

10.4 一句话总结

Q4：Python 导入报错 `ModuleNotFoundError: No module named 'clawdbot'`