词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元,支持一个 Key 调用近 600+ 海内外模型,限时特价模型低至 1 折,欢迎上岸!
~/.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 |
| 相关 skill | hermes-agent |
hermes setup 向导会自动检测 ~/.openclaw,并在配置开始前提供迁移选项。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/...。~/.hermes/skills/migration/openclaw-migration/ 下的已安装路径。SKILL.md 解析脚本路径。find 作为备用方案。workdir: "~"。请使用绝对目录(如用户主目录),或完全省略 workdir。--migrate-secrets 时,还将导入一小组 Hermes 兼容的白名单 secret,目前包括:TELEGRAM_BOT_TOKENclarify 工具可用,使用它处理用户决策,而非要求自由格式的文字回复。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 providedSOUL.md 冲突,使用 clarify,选项如:keep existingoverwrite with backupreview firstkind="skill" 项的 status="conflict",使用 clarify,选项如:keep existing skillsoverwrite conflicting skills with backupimport conflicting skills under renamed foldersclarify,选项如:skip workspace instructionscopy to a workspace pathdecide laterclarify 问题,要求提供绝对路径。skip workspace instructions 或 decide later,继续执行而不添加 --workspace-target。clarify,提供以下 3 个选项:user-data onlyfull compatible migrationcanceluser-data only 表示:迁移用户数据和兼容配置,但不导入白名单 secret。full compatible migration 表示:迁移相同的兼容用户数据,并在存在时导入白名单 secret。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。report.summary。status 恰好为 migrated 时,才将该项列入"已成功迁移"。migrated,否则不得声称冲突已解决。kind="soul" 的报告项 status="migrated",否则不得声称 SOUL.md 已被覆盖。report.summary.conflict > 0,包含冲突部分,而非静默暗示成功。output_dir 路径,以便用户检查 report.json、summary.md、备份和归档文件。details.overflow_file 存在,说明完整溢出列表已导出到该位置。details.renamed_from。report.skill_conflict_mode 存在,将其作为所选已导入 skill 冲突策略的事实来源。status="skipped",不得将其描述为已覆盖、已备份、已迁移或已解决。kind="soul" 的 status="skipped" 且原因为 Target already matches source,说明其保持不变,不提及备份。details.backup 为空,不得暗示现有 Hermes skill 已被重命名或备份。仅说明已导入的副本被放置在新目标位置,并将 details.renamed_from 作为保持原位的已有文件夹引用。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 或主目录作为工作区目标。请先明确询问工作区路径。~/.openclaw/workspace/)而非 workspace.default/。仅在主文件缺失时才使用默认工作区作为备用。SOUL.md 或溢出的记忆条目,在执行前单独指出这些情况。user-data only。workspace-agents。--include / --exclude 视为高级逃生通道,而非正常流程。clarify 可用,不得在 dry run 摘要结尾使用含糊的"您希望怎么做?"。改用结构化的后续提示。clarify 提示。优先使用可选选项,仅对绝对路径或文件审查请求使用自由文本。clarify。SOUL.md 冲突clarify 来呈现它们。workspace-agents 是否仍未解决。如果是,下一个动作必须是工作区指令的 clarify 调用。clarify 答案之后,如果还有其他必要决策待处理,不要叙述刚刚决定的内容。立即提出下一个必要问题。~/.hermes/skills/openclaw-imports/ 下可用的 OpenClaw skill