词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Openclaw Migration — 将用户的 OpenClaw 自定义配置迁移到 Hermes Agent"
Openclaw Migration
~/.openclaw 导入 Hermes 兼容的记忆、SOUL.md、命令白名单、用户技能及所选工作区资产，并精确报告无法迁移的内容及原因。Skill 元数据
| 来源 | 可选 — 通过 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 |
| 相关 skill | hermes-agent |
参考：完整 SKILL.md
信息
OpenClaw -> Hermes 迁移
CLI 命令
hermes setup 向导会自动检测 ~/.openclaw，并在配置开始前提供迁移选项。此 skill 的功能
scripts/openclaw_to_hermes.py 来：SOUL.md 导入 Hermes 主目录，保存为 SOUL.mdMEMORY.md 和 USER.md 转换为 Hermes 记忆条目command_allowlistTELEGRAM_ALLOWED_USERS 和 MESSAGING_CWD~/.hermes/skills/openclaw-imports/workspace/tts/）镜像到 ~/.hermes/tts/路径解析
scripts/openclaw_to_hermes.py~/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py~/.hermes/skills/openclaw-migration/...。1.
~/.hermes/skills/migration/openclaw-migration/ 下的已安装路径。2.
SKILL.md 解析脚本路径。3.
find 作为备用方案。4.
workdir: "~"。请使用绝对目录（如用户主目录），或完全省略 workdir。--migrate-secrets 时，还将导入一小组 Hermes 兼容的白名单 secret，目前包括：TELEGRAM_BOT_TOKEN默认工作流
1.
2.
3.
clarify 工具可用，使用它处理用户决策，而非要求自由格式的文字回复。4.
5.
6.
7.
8.
用户交互协议
clarify 工具进行交互式提示，但有以下限制：Other 自由文本选项clarify 调用：questionchoiceschoices 限制为 2-4 个纯字符串选项...在此输入目录、空白行或下划线 _____clarify 调用返回错误，检查错误文本，修正 payload，并使用有效的 question 和干净的 choices 重试一次。clarify 可用且 dry run 揭示任何需要用户决策的情况时，下一个动作必须是 clarify 工具调用。不得以如下普通助手消息结束对话：
clarify 收集。如果存在多个未解决的决策，不要在它们之间插入解释性助手消息。收到一个
clarify 响应后，下一个动作通常应是下一个必要的 clarify 调用。workspace-agents 视为未解决的决策：kind="workspace-agents"status="skipped"No workspace target was provided1.
SOUL.md 冲突，使用 clarify，选项如：keep existingoverwrite with backupreview first2.
kind="skill" 项的 status="conflict"，使用 clarify，选项如：keep existing skillsoverwrite conflicting skills with backupimport conflicting skills under renamed folders3.
clarify，选项如：skip workspace instructionscopy to a workspace pathdecide later4.
clarify 问题，要求提供绝对路径。5.
skip workspace instructions 或 decide later，继续执行而不添加 --workspace-target。6.
clarify，提供以下 3 个选项：user-data onlyfull compatible migrationcancel7.
user-data only 表示：迁移用户数据和兼容配置，但不导入白名单 secret。8.
full compatible migration 表示：迁移相同的兼容用户数据，并在存在时导入白名单 secret。9.
clarify 不可用，以普通文本提出相同问题，但仍将答案限制为 user-data only、full compatible migration 或 cancel。No workspace target was provided 导致的 workspace-agents 跳过仍未解决时，不得执 行。skip workspace instructionsdecide latercopy to a workspace path 后提供了工作区路径clarify 决策仍未解决时，不得执行。clarify payload 形式作为默认模式：{"question":"Your existing SOUL.md conflicts with the imported one. What should I do?","choices":["keep existing","overwrite with backup","review first"]}{"question":"One or more imported OpenClaw skills already exist in Hermes. How should I handle those skill conflicts?","choices":["keep existing skills","overwrite conflicting skills with backup","import conflicting skills under renamed folders"]}{"question":"Choose migration mode: migrate only user data, or run the full compatible migration including allowlisted secrets?","choices":["user-data only","full compatible migration","cancel"]}{"question":"Do you want to copy the OpenClaw workspace instructions file into a Hermes workspace?","choices":["skip workspace instructions","copy to a workspace path","decide later"]}{"question":"Please provide an absolute path where the workspace instructions should be copied."}决策到命令的映射
SOUL.md 选择 keep existing，不添加 --overwrite。overwrite with backup，添加 --overwrite。review first，在执行前停止并审查相关文件。keep existing skills，添加 --skill-conflict skip。overwrite conflicting skills with backup，添加 --skill-conflict overwrite。import conflicting skills under renamed folders，添加 --skill-conflict rename。user-data only，使用 --preset user-data 执行，不添加 --migrate-secrets。full compatible migration，使用 --preset full --migrate-secrets 执行。--workspace-target。skip workspace instructions 或 decide later，不添加 --workspace-target。运行后报告规则
1.
report.summary。2.
status 恰好为 migrated 时，才将该项列入"已成功迁移"。3.
migrated，否则不得声称冲突已解决。4.
kind="soul" 的报告项 status="migrated"，否则不得声称 SOUL.md 已被覆盖。5.
report.summary.conflict > 0，包含冲突部分，而非静默暗示成功。6.
7.
output_dir 路径，以便用户检查 report.json、summary.md、备份和归档文件。8.
details.overflow_file 存在，说明完整溢出列表已导出到该位置。9.
details.renamed_from。10.
report.skill_conflict_mode 存在，将其作为所选已导入 skill 冲突策略的事实来源。11.
status="skipped"，不得将其描述为已覆盖、已备份、已迁移或已解决。12.
kind="soul" 的 status="skipped" 且原因为 Target already matches source，说明其保持不变，不提及备份。13.
details.backup 为空，不得暗示现有 Hermes skill 已被重命名或备份。仅说明已导入的副本被放置在新目标位置，并将 details.renamed_from 作为保持原位的已有文件夹引用。迁移 preset
user-datafulluser-data 包含：soulworkspace-agentsmemoryuser-profilemessaging-settingscommand-allowlistskillstts-assetsarchivefull 包含 user-data 中的所有内容，另加：secret-settings--include / --exclude，但将其视为高级备用方案，而非默认用户体验。命令
{"command":"python3 /home/USER/.hermes/skills/migration/openclaw-migration/scripts/openclaw_to_hermes.py","workdir":"/home/USER"}$PWD 或主目录作为工作区目标。请先明确询问工作区路径。重要规则
1.
2.
3.
4.
5.
~/.openclaw/workspace/）而非 workspace.default/。仅在主文件缺失时才使用默认工作区作为备用。6.
7.
SOUL.md 或溢出的记忆条目，在执行前单独指出这些情况。8.
user-data only。9.
workspace-agents。10.
--include / --exclude 视为高级逃生通道，而非正常流程。11.
clarify 可用，不得在 dry run 摘要结尾使用含糊的"您希望怎么做？"。改用结构化的后续提示。12.
clarify 提示。优先使用可选选项，仅对绝对路径或文件审查请求使用自由文本。13.
clarify。14.
SOUL.md 冲突15.
clarify 来呈现它们。16.
workspace-agents 是否仍未解决。如果是，下一个动作必须是工作区指令的 clarify 调用。17.
clarify 答案之后，如果还有其他必要决策待处理，不要叙述刚刚决定的内容。立即提出 下一个必要问题。预期结果
~/.hermes/skills/openclaw-imports/ 下可用的 OpenClaw skill