# OpenClaw-to-Hermes

> 仓库地址：https://github.com/0xNyk/openclaw-to-hermes
> 作者/组织：0xNyk
> 成熟度：beta
> 分析日期：2026-04-15

## 一句话总结
从 OpenClaw 到 Hermes Agent 的生产级迁移工具，处理配置转换、凭证迁移、workspace 资产转移和 systemd 服务配置。

## 项目定位与架构
该工具诞生于真实生产迁移经验——官方 `hermes-migrate` 命令存在复杂模型配置崩溃、认证文件格式错误、workspace 文件检测不完整等问题。作者将这些修复封装为独立工具。

架构清晰：Source（OpenClaw 的 `~/.openclaw/openclaw.json` + `~/clawd/` + `/etc/openclaw-tenants/`）→ Target（Hermes 的 `~/.hermes/config.yaml` + `memories/` + `auth.json` + `.env`）。支持 dry-run 预览、备份存档、单 agent 迁移。

值得注意的是：自 Hermes Agent v0.3.0+ 起，原生 `hermes claw migrate` 已吸收了这些修复，新迁移推荐使用原生命令。

## 关键技术特性
- **全面迁移覆盖**：personality files (SOUL.md)、memory 文档、workspace 资产、custom skills、memory archives、cron 配置
- **配置映射**：OpenClaw JSON → Hermes YAML，含 model preferences、channel bindings、tool bindings
- **凭证处理**：多源（文件、环境变量、系统级存储）凭证收集和格式转换
- **安全设计**：迁移前创建备份存档、dry-run 预览模式
- **自定义配置**：`~/.oc2hermes.yaml` 支持 workspace 检测、阶段跳过、model ID 重映射

## 设计亮点与创新
从实际生产痛点出发的工具设计很务实。处理了边缘情况：复杂 model 配置对象（字典格式含 primary/fallback models）、过期 token、系统级环境凭证等。`--dry-run` 和备份存档的安全设计体现了生产级思维。

## 局限性与风险
随着 Hermes v0.3.0+ 原生迁移的改进，该工具的主要价值转向参考实现和旧版本兼容。仅支持 Linux + systemd 环境。依赖 OpenClaw 特定的文件布局。

## 与生态系统的关联
作为 OpenClaw → Hermes 过渡期的桥梁工具，反映了 Hermes 生态的演进历史。其修复最终被上游吸收，体现了社区贡献反哺核心项目的健康模式。