OpenClaw = 消息网关 + Skills 生态 + 轻量记忆

Hermes Agent = 持久记忆 + 自动学习 + 研究平台

OpenClaw 架构：
┌─────────────────────────────────────────────────────────┐
│                    OpenClaw Gateway                     │
├─────────────────────────────────────────────────────────┤
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐│
│  │  Skills │  │ Memory  │  │ Gateway │  │  Cron   ││
│  │ Manager │  │ Manager │  │ (微信等) │  │ Trigger ││
│  └────┬────┘  └────┬────┘  └────┬────┘  └────┬────┘│
│       │             │             │             │      │
└───────┴─────────────┴─────────────┴─────────────┴──────┘

Hermes Agent 架构：
┌─────────────────────────────────────────────────────────┐
│                   Hermes Agent Core                      │
├─────────────────────────────────────────────────────────┤
│  ┌──────────────────────────────────────────────────┐ │
│  │              持久记忆系统（三层）                 │ │
│  │  Honcho 用户画像 │ Skills 记忆 │ FTS5 会话记忆  │ │
│  └──────────────────────────────────────────────────┘ │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐│
│  │  Skills │  │  Gateway│  │  Cron   │  │  MLOps  ││
│  │ Auto-Gen│  │ (多平台)│  │ 调度器  │  │ 研究引擎││
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘│
│  ┌──────────────────────────────────────────────────┐ │
│  │              7 种终端后端                         │ │
│  │ Local │ Docker │ SSH │ Singularity │ Modal │ ... │ │
│  └──────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘

MEMORY.md 结构：
# MEMORY.md - 长期记忆
## 关于用户
- 名字：XXX
- 时区：Asia/Shanghai

## 项目背景
- 正在开发：XXX 项目

## 偏好设置
- 天气单位：摄氏度

三层架构：
┌─────────────────────────────────────────────────────────┐
│ Layer 1: Honcho 用户画像                               │
│ - 工作习惯建模                                         │
│ - 偏好自动推断                                         │
│ - 跨会话学习                                           │
├─────────────────────────────────────────────────────────┤
│ Layer 2: Skills 技能记忆                               │
│ - 自动创建可复用技能                                   │
│ - 使用中自动优化                                       │
│ - 可搜索、可分享                                       │
├─────────────────────────────────────────────────────────┤
│ Layer 3: FTS5 会话记忆                                 │
│ - 全文搜索快速检索                                     │
│ - LLM 摘要压缩                                         │
│ - 上下文智能补全                                       │
└─────────────────────────────────────────────────────────┘

# SKILL.md
## 触发条件
用户说"..."时触发

## 执行步骤
1. ...
2. ...

## 输出格式
...

# SKILL.md (agentskills.io 标准)
## 触发条件
- 自动学习生成
- 可手动扩展

## 技能参数
- param1: 描述
- param2: 描述

## 执行逻辑
- 自动优化
- 使用中学习

## 分享
- 可发布到 Skills Hub

用户：我现在在做一个电商项目，叫 ShopX
     主要是卖数码产品

OpenClaw：
→ 将信息写入 MEMORY.md
→ 下次对话时读取

问题：
- 用户需要主动更新
- 容易遗漏重要信息
- 无上下文关联

用户：我现在在做一个电商项目，叫 ShopX
     主要是卖数码产品

Hermes Agent：
→ 分析并存储到 Honcho 用户画像
→ 自动关联到 Skills 记忆
→ 提取关键信息到 FTS5 索引
→ 主动学习项目结构

效果：
- 无需手动更新
- 主动关联已有信息
- 越用越了解项目

用户：帮我分析这段代码的安全问题
     （包含 SQL 注入风险）

OpenClaw：
→ 完成分析
→ 等待用户说"把这个记为技能"
→ 手动创建 SKILL.md

问题：
- 需要用户主动触发
- 容易忘记创建
- 技能更新不及时

用户：帮我分析这段代码的安全问题
     （包含 SQL 注入风险）

Hermes Agent：
→ 完成分析
→ 自动检测这是可复用的问题
→ 自动创建/更新 Skills
→ 下次遇到类似问题直接调用

效果：
- 无需手动触发
- 技能在使用中进化
- 可分享到社区

微信消息 → OpenClaw Gateway → 直接处理
           ↓
    原生支持，无延迟，无额外依赖

微信消息 → HermesClaw → Hermes Agent → 处理结果 → HermesClaw → 微信
                    ↓
              需要额外服务

问题：每次都要重新解释项目背景
OpenClaw：手动维护 MEMORY.md
Hermes：自动学习，越用越懂你

问题：需要大量轨迹数据训练模型
OpenClaw：不支持
Hermes：批量生成 + Atropos RL

问题：主要使用 Telegram/Discord
OpenClaw：需要额外配置
Hermes：原生支持，体验最佳

问题：需要在 Docker/SSH/Modal 等环境执行
OpenClaw：支持有限
Hermes：7 种终端后端自由切换

问题：想要可移植的 Skills
OpenClaw：自定义格式
Hermes：agentskills.io 开放标准

如果你的日常沟通主要在微信
OpenClaw：原生支持，即装即用
Hermes：需要 HermesClaw 桥接

如果已经为 OpenClaw 编写了很多 Skills
迁移成本：中等（需要手动调整格式）

OpenClaw：一键安装，开箱即用
Hermes：需要更多配置

□ OpenClaw 版本 >= 1.0.0
□ 工作区路径：~/.openclaw/workspace
□ 已备份所有重要数据
□ 有 Telegram Bot Token（如果需要）
□ 有 OpenRouter API Key（或其他模型提供商）

hermes claw migrate

# OpenClaw SOUL.md
# Hermes Agent SOUL.md

# OpenClaw MEMORY.md
- 名字：XXX
- 时区：Asia/Shanghai

# OpenClaw USER.md
# 转换为 Hermes Honcho 格式

OpenClaw Skills/
├── skill1/
│   └── SKILL.md
├── skill2/
│   └── SKILL.md

┌─────────────────────────────────────────────────────────────────┐
│                        完整迁移流程                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  1️⃣  安装 Hermes Agent                                          │
│      └─ curl -fsSL .../install.sh | bash                        │
│                                                                  │
│  2️⃣  运行迁移命令                                                │
│      └─ hermes claw migrate --source ~/.openclaw/workspace      │
│         ↓                                                        │
│      ┌─────────────────────────────────────────┐                  │
│      │  迁移检测：                              │                  │
│      │  ✓ SOUL.md                              │                  │
│      │  ✓ MEMORY.md                            │                  │
│      │  ✓ USER.md                              │                  │
│      │  ✓ Skills (X 个)                        │                  │
│      │  ✓ API Keys                             │                  │
│      │  ✓ AGENTS.md                            │                  │
│      └─────────────────────────────────────────┘                  │
│         ↓                                                        │
│      3️⃣  格式转换                                                │
│         - 记忆 → Honcho 格式                                    │
│         - Skills → agentskills.io 格式                          │
│         - API Keys → 环境变量                                   │
│         ↓                                                        │
│      4️⃣  导入完成                                                │
│         └─ 建议：启动前先 review 导入结果                        │
│         ↓                                                        │
│      5️⃣  启动 Hermes                                            │
│         └─ hermes                                               │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

# 1. 检查记忆是否正确导入
hermes memory list

# 2. 检查 Skills 是否可用
hermes skills list

# 3. 检查配置是否正确
hermes doctor --check-migration

# 4. 测试对话
hermes
> 你还记得我叫什么吗？
> 我们的项目是什么？

微信 ←→ HermesClaw ←→ Hermes Agent

# 克隆仓库
git clone https://github.com/AaronWong1999/hermesclaw.git
cd hermesclaw

# 安装依赖
npm install

# 配置
cp config.example.yaml config.yaml
# 编辑 config.yaml 填写微信和 Hermes 配置

# 启动
npm start

# config.yaml
wechat:
  # 微信配置（需要已有微信账号）
  account: "your-wechat-account"

hermes:
  # Hermes Agent 地址
  endpoint: "http://localhost:8000"
  api_key: "your-hermes-api-key"

routing:
  # 消息路由规则
  rules:
    - keyword: "hermes"
      target: "hermes"  # 包含关键词的消息发到 Hermes
    - keyword: "openclaw"
      target: "openclaw"  # 包含关键词的消息发到 OpenClaw
    - default: "hermes"   # 默认发到 Hermes

routing:
  rules:
    - keyword: "h"
      target: "hermes"      # h 开头的消息 → Hermes
    - keyword: "o"
      target: "openclaw"     # o 开头的消息 → OpenClaw
    - default: "hermes"      # 默认 → Hermes

multi_agent:
  enabled: true
  agents:
    hermes:
      name: "Hermes"
      avatar: "🤖"
    openclaw:
      name: "OpenClaw"
      avatar: "🦞"

OpenClaw：
- 微信日常助手
- 快速问答
- 本地文件处理

Hermes Agent：
- Telegram/CLI 深度任务
- 研究任务（轨迹生成）
- 定时任务（因为自然语言更方便）

# OpenClaw - 专注微信
openclaw:
  platform: wechat
  primary_channel: wechat

# Hermes - 专注其他
hermes:
  platforms:
    - telegram
    - discord
  default_platform: telegram

微信消息
  │
  ├─ [h xxx] ──→ HermesClaw ──→ Hermes Agent ──→ 回复
  │
  └─ [o xxx] ──→ HermesClaw ──→ OpenClaw ──→ 回复

上午：
□ 阅读本迁移指南
□ 备份 OpenClaw 数据
□ 安装 Hermes Agent

下午：
□ 运行迁移工具
□ 验证记忆导入
□ 基本配置测试

□ 熟悉 Hermes 基本操作
□ 配置 HermesClaw（如果需要微信）
□ 逐步将定时任务迁移到 Hermes
□ 测试 Skills 功能

□ 评估 Hermes 是否满足需求
□ 决定是否完全迁移
□ 或者确定共存方案

# 检查记忆导入状态
hermes memory list

# 手动导入缺失的记忆
hermes memory add --type user --content "你的记忆内容"

# 查看 Skills 错误
hermes skills debug skill-name

# 手动调整格式
# 参考 agentskills.io 标准

# 检查 HermesClaw 状态
npm run status

# 检查日志
tail -f logs/hermesclaw.log

# 重启服务
npm restart

# 停止 Hermes
# Hermes Agent 只是另一个程序
# OpenClaw 不受影响

# OpenClaw
openclaw:
  port: 3000

# Hermes
hermes:
  port: 8000

第一步：今天
  → 安装 Hermes Agent（不删除 OpenClaw）
  → 导入现有数据
  → 体验一周

第二步：一周后
  → 评估是否满足需求
  → 决定：迁移 / 共存 / 继续用 OpenClaw

第三步：一个月后
  → 完成习惯转换
  → 优化配置
  → 分享经验给社区