{/* This page is auto-generated from the skill’s SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Openclaw Migration

将用户的 OpenClaw 自定义足迹迁移到 Hermes Agent。从 ~/.openclaw 导入 Hermes 兼容的记忆、SOUL.md、命令允许列表、用户技能和选定的工作空间资产，然后报告无法迁移的内容及其原因。

技能元数据


来源	可选 —— 通过 `hermes skills install official/migration/openclaw-migration` 安装
路径	`optional-skills/migration/openclaw-migration`
版本	`1.0.0`
作者	Hermes Agent (Nous Research)
许可协议	MIT
平台	linux, macos, windows
标签	`Migration`, `OpenClaw`, `Hermes`, `Memory`, `Persona`, `Import`
相关技能	`hermes-agent`

参考：完整 SKILL.md

:::info 以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。 :::

OpenClaw → Hermes 迁移

当用户希望以最小的人工清理工作量将其 OpenClaw 设置迁移到 Hermes Agent 时，使用此技能。

CLI 命令

对于快速、非交互式迁移，使用内置的 CLI 命令：

hermes claw migrate              # 完整交互式迁移
hermes claw migrate --dry-run    # 预览将迁移的内容
hermes claw migrate --preset user-data   # 迁移时不包含密钥
hermes claw migrate --overwrite  # 覆盖现有冲突
hermes claw migrate --source /custom/path/.openclaw  # 自定义源

CLI 命令运行与下方描述的相同的迁移脚本。当需要交互式、引导式迁移时，通过代理使用此技能。

首次设置： hermes setup 向导自动检测 ~/.openclaw 并在配置开始前提供迁移选项。

此技能的功能

使用 scripts/openclaw_to_hermes.py 来：

将 SOUL.md 导入 Hermes 主目录作为 SOUL.md
将 OpenClaw 的 MEMORY.md 和 USER.md 转换为 Hermes 记忆条目
将 OpenClaw 命令批准模式合并到 Hermes command_allowlist 中
迁移 Hermes 兼容的消息设置，如 TELEGRAM_ALLOWED_USERS 和 MESSAGING_CWD
将 OpenClaw 技能复制到 ~/.hermes/skills/openclaw-imports/
可选择将 OpenClaw 工作空间指令文件复制到选定的 Hermes 工作空间
镜像兼容的工作空间资产，如 workspace/tts/ 到 ~/.hermes/tts/
归档没有直接 Hermes 目标的非机密文档
生成结构化报告，列出已迁移项、冲突项、跳过项及其原因

路径解析

辅助脚本位于此技能目录中：

scripts/openclaw_to_hermes.py

当此技能从技能中心安装时，正常位置是：

~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py

不要猜测更短的路径如 ~/.hermes/skills/openclaw-migration/...。

默认工作流

先通过干运行进行检查。
提供可迁移内容、不可迁移内容和将归档内容的简单摘要。
如果 clarify 工具可用，用于用户决策替代要求自由格式的散文回复。
如果干运行发现导入的技能目录冲突，在执行前询问如何处理。
在执行前要求用户在两种支持的迁移模式之间选择。
仅当用户希望将工作空间指令文件带过来时才询问目标工作空间路径。
使用匹配的预设和标志执行迁移。
总结结果，特别是：
- 已迁移的内容
- 需要人工审查的归档内容
- 被跳过及原因的内容

用户交互协议

Hermes CLI 支持 clarify 工具用于交互式提示，但它仅限于：

一次一个选择
最多 4 个预定义选择
一个自动的 Other 自由文本选项

不支持单个提示中的真正多选复选框。

每次 clarify 调用：

始终包含非空的 question
仅对真正的可选择提示包含 choices
保持 choices 在 2-4 个纯字符串选项
永远不要发出占位符或截断选项如 ...
永远不要用额外空白填充或修饰选择
永远不要在问题中包含假表单字段，如 在此输入目录、填空空行或下划线如 _____
对于开放式路径问题，仅询问简单句子；用户在面板下方的正常 CLI 提示中键入

如果 clarify 调用返回错误，检查错误文本，更正负载，并用有效的 question 和干净的选择重试一次。

迁移预设

正常使用中预设这两种：

user-data
full

user-data 包括：soul、workspace-agents、memory、user-profile、messaging-settings、command-allowlist、skills、tts-assets、archive

full 包括 user-data 中的所有内容外加：secret-settings

命令

干运行：

python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py

使用 user-data 预设的干运行：

python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --preset user-data

执行 user-data 迁移：

python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --execute --preset user-data --skill-conflict skip

执行完整兼容迁移：

python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --execute --preset full --migrate-secrets --skill-conflict skip

带工作空间指令的执行：

python3 ~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py --execute --preset user-data --skill-conflict rename --workspace-target "/absolute/workspace/path"

预期结果

成功运行后，用户应拥有：

已导入的 Hermes 角色状态
填充了转换后的 OpenClaw 知识的 Hermes 记忆文件
~/.hermes/skills/openclaw-imports/ 下可用的 OpenClaw 技能
显示任何冲突、遗漏或不支持数据的迁移报告

有关完整的用户交互协议、决策到命令的映射、执行后报告规则和重要规则的详细信息，请参阅源 SKILL.md。

好奇心花园🪴

探索

最近的笔记

note-template

getMoon.js

getWeather.js

Openclaw Migration —— 将用户的 OpenClaw 自定义足迹迁移到 Hermes Agent