模型配置
config.yaml 里的默认模型、providers 和自定义 OpenAI-compatible endpoints 会被整理过来。
Install 导读
Migrating from Hermes：整理模型、记忆、技能和钥匙
这页教 Hermes 用户把模型配置、MCP servers、工作区文件、记忆和 skills 导入 OpenClaw。默认先预览、打码、备份，再应用；API key 默认不搬，只有明确使用 --include-secrets 时才会导入支持的 .env secrets。
先讲这一页到底在解决什么
Migrating from Hermes：整理模型、记忆、技能和钥匙
这页教 Hermes 用户把模型配置、MCP servers、工作区文件、记忆和 skills 导入 OpenClaw。默认先预览、打码、备份，再应用；API key 默认不搬，只有明确使用 --include-secrets 时才会导入支持的 .env secrets。
第一站
🧭 先选路：第一次用向导，想可重复就用 CLI
Hermes 默认位置通常是 ~/.hermes，但你也可以手动指定来源。
openclaw onboard --flow import像打开新家入住向导。它发现 ~/.hermes 后，会先给你看搬家预览。
openclaw onboard --import-from hermes --import-source ~/.hermes如果 Hermes 不在默认柜子里，就把柜子地址讲清楚。
openclaw migrate hermes --dry-run只看清单，不动现场。适合先让人放心。
openclaw migrate apply hermes --yes确认后才真正导入。它会先做并验证备份。
第二站
📦 会搬哪些行李：模型、工具、记忆、技能
这页的主体其实是在分拣 Hermes 状态。
MCP servers
mcp_servers 或 mcp.servers 里的工具服务器定义会被识别。
工作区和记忆
SOUL.md、AGENTS.md 会复制；MEMORY.md、USER.md 会追加，不是粗暴覆盖。
Skills
skills/<name>/SKILL.md 和相关技能配置会跟着搬。
第三站
🔐 secrets 默认留在原地，因为钥匙不能随便塞进口袋
这是 Hermes 迁移最该讲清楚的一条安全线。
默认不搬
API keys 不会自动复制。这样就算你只是试跑迁移，也不会不小心把钥匙带进新系统。
--include-secrets只有你明确加这个开关，OpenClaw 才会导入支持名单里的 .env key。
支持的 key
包括 OPENAI_API_KEY、ANTHROPIC_API_KEY、OPENROUTER_API_KEY、GOOGLE_API_KEY、GEMINI_API_KEY 等常见供应商钥匙。
SecretRef 怎么办
SecretRef 管理的凭据要在导入后单独配置来源，不要指望迁移命令替你猜。
第四站
📁 有些旧物只进档案盒，不会直接变成 live 配置
这不是偷懒，而是因为两个系统对“信任这些状态”的规则可能不同。
只归档
plugins/、sessions/、logs/、cron/、mcp-tokens/、auth.json、state.db 会进迁移报告目录供人工检查。
为什么不直接用
旧格式和信任边界可能已经变了。OpenClaw 不会自动执行或信任这些状态。
--overwrite只有你确定要替换已有目标时才用。否则冲突时 apply 会停下来。
中途冲突
如果一个配置文件突然冲突，后面依赖它的项目会标成 skipped，不会写一半留一半。
最后记住
🎈 Hermes 迁移像整理行李箱：能用的放进衣柜，危险的先贴标签
最稳的顺序是：--dry-run 看计划，apply 导入，按需 --include-secrets，再跑 openclaw doctor、重启 Gateway、看 openclaw status。