Hermes Agent vs OpenClaw：完整迁移指南

1. 背景：OpenClaw 是什么

OpenClaw 是 Hermes Agent 的前身项目，由相同的核心团队开发。它是一个 AI Agent CLI 工具，具备：

• • 基础的终端对话能力
• • 简单的消息平台接入（主要是 Telegram）
• • 基于文件的记忆系统（MEMORY.md / USER.md）
• • 有限的技能（Skills）系统
• • 单一的 Provider 支持

OpenClaw 建立了 Hermes Agent 的核心设计思路："持久化个人 AI Agent"，但在规模化、稳定性、安全性和功能深度上存在明显局限。

Hermes Agent 是 OpenClaw 的完整重写和大规模升级，不是简单的版本迭代，而是整个架构的脱胎换骨。

2. Hermes Agent 是什么

Hermes Agent 是由 Nous Research^[1] 开发的自我进化 AI Agent，核心差异化在于：

"唯一具备内置学习循环的 Agent" —— 它从经验中创造技能，在使用中改进技能，并在训练下一代工具调用模型（RL 管道）。

 ┌─────────────────────────────────┐
 │         Hermes Agent             │
│                                  │
│  CLI ◄──────► Gateway            │
 │               │                  │
│        ┌──────┴──────┐           │
│        │  Telegram   │           │
 │        │  Discord    │           │
 │        │  Slack      │           │
│        │  WhatsApp   │           │
│        │  Signal     │           │
│        │  飞书/微信  │            │
│        │  Matrix     │           │
│        │  ...        │           │
│        └─────────────┘           │
│                                  │
│  Skills (70+) ◄──► Memory        │
│  Cron Scheduler ◄──► Tools       │
│  Sub-Agents ◄──────► RL Training │
└─────────────────────────────────┘

3. 核心区别一览

4. Hermes Agent 相对 OpenClaw 的全面升级

4.1 架构重构

OpenClaw 采用单体脚本架构，所有功能混在少数几个文件中。Hermes Agent 完全重写为模块化架构：

提供商路由中心化

OpenClaw: 每个功能（视觉/摘要/压缩）各自调用 API，逻辑分散
Hermes:   统一 call_llm()/async_call_llm() API，所有消费者共享单一代码路径

带来的好处：

• • 自动凭据解析（credential resolution）
• • 统一的 fallback 链：主 Provider → 备用 Provider → 凭据池轮转
• • 所有工具调用的 rate-limit、retry 行为一致

插件系统（Plugin System）

OpenClaw 无插件系统，定制需 fork 代码。Hermes Agent 引入完整插件架构：

# ~/.hermes/plugins/my_plugin.py
class MyPlugin:
    # 生命周期钩子
    async def pre_llm_call(self, ctx): ...
    async def post_llm_call(self, ctx): ...
    async def on_session_start(self, ctx): ...
    async def on_session_end(self, ctx): ...
    
    # 注册自定义 CLI 子命令
    def register_cli_commands(self, cli): ...
    
    # 注册自定义工具
    def get_tools(self): ...

Profiles 多实例系统（v0.6.0 新增）

OpenClaw 只能运行单一实例。Hermes Agent 引入 Profiles：

hermes profile create work        # 创建工作用 Profile
hermes profile create personal    # 创建个人用 Profile
hermes -p work                    # 以 work profile 启动

# 每个 Profile 完全隔离：
# - 独立的 config、memory、sessions、skills
# - 独立的 gateway 服务
# - Token 锁防止凭据冲突
hermes profile export work        # 导出分享
hermes profile import work.tar.gz # 导入

4.2 模型与提供商支持

OpenClaw 支持的提供商（约 2-3 个）：

• • OpenRouter（有限）
• • OpenAI（有限）
• • 少量自定义端点

Hermes Agent 支持的提供商（20+）：

关键特性升级：

同 Provider 凭据池（v0.7.0 新增）

# config.yaml
credential_pool:
  - provider: openai
    api_key: sk-key1
  - provider: openai
    api_key: sk-key2
  - provider: openai
    api_key: sk-key3
# 自动 least_used 轮转，401 时自动切换到下一个

有序 Fallback 链（v0.6.0 新增）

fallback_providers:
  - openrouter
  - nous
  - anthropic
# 主 Provider 错误时自动降级，不丢失上下文

实时模型切换（v0.8.0 新增）

# CLI 中
/model anthropic:claude-opus-4.6

# Telegram/Discord 中
/model  # 弹出交互式选择器（内联按钮）

自我优化的 GPT/Codex 工具调用（v0.8.0 新增）
Agent 自己诊断并修复了 GPT 和 Codex 的 5 个工具调用失败模式，通过自动化行为 benchmark 实现。

4.3 消息平台网关

这是 Hermes Agent 相对 OpenClaw 最显著的提升之一。

OpenClaw 消息平台：

• • Telegram（基础，不稳定）
• • 其他平台支持极少

Hermes Agent 消息平台（10+ 个，生产级）：

网关核心改进：

自动重连（v0.4.0 新增）
平台连接失败时指数退避自动重连，OpenClaw 中一次网络中断可能导致整个网关崩溃。

基于活动的智能超时（v0.8.0 新增）

OpenClaw/旧版: 挂钟时间超时（长任务被错杀）
Hermes v0.8.0: 实际工具活动追踪（正在工作的任务永不被杀，只有真正空闲才超时）

背景任务完成通知（v0.8.0 新增）

# Agent 启动后台任务（AI 训练、测试、部署）后继续其他工作
# 任务完成时自动通知用户
notify_on_complete=True

4.4 记忆与会话系统

OpenClaw 记忆系统：

• • 基础的 MEMORY.md 文件
• • 手动管理，无搜索能力
• • 并发写入时数据丢失

Hermes Agent 记忆系统：

可插拔记忆提供商（v0.7.0 架构重构）

内置记忆（默认）
    ├── MEMORY.md / USER.md
    ├── FTS5 全文搜索（SQLite）
    └── 自动异步刷新

外部记忆提供商（插件）
    ├── Honcho   — AI 原生跨会话用户建模，多租户
    ├── mem0     — API v2 兼容，秘密脱敏
    ├── Supermemory — 多容器，搜索模式
    ├── RetainDB — API 路由，辩证记忆
    └── ByteRover — 同步前置 LLM 调用

会话搜索与管理

/history          # 浏览最近会话（带标题和预览）
/resume <名称>   # 按名称恢复会话
/search <关键词>  # FTS5 全文搜索历史
/insights --days 30  # 使用分析、费用估算、活动规律

SQLite 后端（完全替代 JSON 文件）

• • 并发安全（WAL 模式）
• • 4 个 SessionDB 方法加线程锁
• • 跨平台网关会话持久化
• • 会话转录不再重复积累（OpenClaw 中存在 3-4x token 膨胀的 bug）

4.5 技能生态系统

OpenClaw 技能系统：

• • 数量有限，手动安装
• • 无技能市场
• • 无条件激活
• • 无平台差异

Hermes Agent 技能系统（大幅重构）：

规模对比

技能自动学习（核心差异化）
这是 Hermes Agent 相对所有竞品（包括 OpenClaw）最独特的功能：

用户完成复杂任务
       ↓
Agent 将经验提炼为可复用 Skill
       ↓
Skill 存储到 ~/.hermes/skills/
       ↓
后续相似任务自动激活该 Skill
       ↓
Skill 在使用中持续改进（自我优化）

部分新增技能（v0.3.0 → v0.8.0）：

研究与写作:  research-paper-writing, llm-wiki
创意工具:   manim-video, p5js, ascii-video, popular-web-designs
开发工具:   claude-code, gitnexus-explorer, docker-management
效率工具:   memento-flashcards, google-workspace, obsidian
社交与数据:  twitter/x, youtube-transcript, polymarket
安全研究:   oss-security-forensics, domain-intelligence, sherlock-osint
协作平台:   linear, agentmail, notion
区块链:     solana, base-blockchain
生物信息:   bioinformatics (400+ 子技能索引)

4.6 安全体系

OpenClaw 的安全机制非常薄弱，Hermes Agent 进行了系统性的安全重构：

执行前安全

OpenClaw: 无预执行扫描
Hermes:   Tirith 静态分析 → 危险命令模式匹配 → 审批工作流 → 执行

秘密保护

OpenClaw: 无秘密保护
Hermes:   
  ✓ 输出自动脱敏（终端、沙箱、网关日志）
  ✓ 浏览器 URL 扫描（防止 prompt injection 泄漏）
  ✓ 保护 .ssh、.aws、.azure、.docker、.config/gh 等凭据目录
  ✓ 供应链攻击 CI 扫描（PR 自动检查）
  ✓ MCP 扩展包 OSV 恶意软件扫描

网络安全

Hermes 新增:
  ✓ SSRF 保护（browser_navigate、vision_tools、web_tools）
  ✓ 私有 IP 和回环地址拒绝
  ✓ shell injection 防护（~user 路径后缀）
  ✓ zip-slip tar traversal 防护
  ✓ 跨会话隔离

依赖供应链安全（v0.5.0 重大改进）

移除被攻击的 litellm 依赖
固定所有依赖版本范围
生成带 hash 的 uv.lock
CI 工作流自动扫描 PR 供应链攻击
升级依赖修复 CVE

MCP 安全（v0.8.0 新增）

完整 OAuth 2.1 PKCE 标准合规认证
MCP 扩展包自动 OSV 漏洞数据库扫描

4.7 工具系统

终端后端（6 种，OpenClaw 仅 1-2 种）

浏览器工具

OpenClaw: 基础 Browserbase
Hermes:   
  - Browserbase（已迁移至 Browser Use）
  - Camofox（反检测本地浏览器，VNC 调试）
  - Firecrawl 云浏览器
  - CDP 连接已有 Chrome 实例（/browser connect）
  - Playwright/headless Chromium（零费用本地方案）

MCP（Model Context Protocol）

OpenClaw: 无
Hermes:
  - 完整 MCP 客户端（stdio + Streamable HTTP 传输）
  - MCP 服务端（hermes mcp serve）
  - OAuth 2.1 PKCE 认证
  - 动态工具发现（无需重连）
  - 采样支持（服务端发起 LLM 请求）
  - ACP 编辑器集成（VS Code/Zed/JetBrains MCP 服务器直接接入）
  - OSV 恶意软件扫描

文件操作

OpenClaw: 基础读写
Hermes:
  ✓ V4A 补丁工具（精细差异编辑）
  ✓ 内联 Diff 预览（写入/补丁前可视化确认）
  ✓ 外部修改检测（写入前检查文件是否被外部修改）
  ✓ .zip 文档支持
  ✓ 超大工具结果保存到文件（而非截断）

语音与多媒体

OpenClaw: 无
Hermes:
  ✓ 语音模式（push-to-talk CLI，Telegram/Discord 语音消息）
  ✓ 本地 Whisper 转录（faster-whisper）
  ✓ TTS（ElevenLabs、MiniMax speech-2.8、NeuTTS 本地 TTS）
  ✓ Discord 语音频道
  ✓ STT 工具（Whisper API）

4.8 CLI 与用户体验

新增交互命令（OpenClaw 没有的）

# 会话管理
/history           # 浏览最近会话
/resume <名称>    # 恢复命名会话
/queue <消息>     # 排队下一条消息（不中断当前任务）
/btw <问题>       # 临时侧问，不影响主对话上下文
/yolo              # 切换危险命令批准（session 级）
/plan              # 从规格生成实施计划
/rollback          # 回滚到检查点
/bg                # 后台进程管理
/verbose           # 切换调试输出
/status            # 实时状态和 token 数量
/insights          # 使用分析、费用估算
/permission        # 动态切换批准模式
/browser connect   # 连接已有 Chrome 实例
/model [...]       # 实时切换模型（带提供商）
/profile           # 显示当前 Profile 信息

# @ 上下文引用（Claude Code 风格）
@file.py           # 注入文件内容
@https://...       # 注入 URL 内容

TUI 改进

OpenClaw: 基础终端输出
Hermes:
  ✓ 持久状态栏（模型、提供商、token 计数）
  ✓ 推理区块实时展示
  ✓ 工具进度流式显示
  ✓ 文件修改内联 Diff 预览
  ✓ 皮肤/主题引擎（7 个内置皮肤 + 自定义 YAML）
  ✓ 文件路径自动补全
  ✓ 上下箭头历史导航
  ✓ 剪贴板图片粘贴（Alt+V）
  ✓ 斜杠命令前缀匹配（/mod → /model）
  ✓ 多行粘贴检测

配置系统

# OpenClaw: 简单 JSON/YAML
# Hermes: 高级配置特性

# config.yaml 中的 ENV 变量替换
api_key: ${MY_SECRET_KEY}

# 实时重载（无需重启）
# custom_models.yaml（用户自管理模型）
# 嵌套 YAML 合并（而非整体替换）
# config set 空值支持

# 多 Profile 完全隔离
hermes config set -p work model.default "anthropic:claude-opus-4.6"
hermes config set -p personal model.default "nous:hermes-3-405b"

4.9 Cron 定时调度

OpenClaw Cron：

• • 基础 Cron 功能，多处 bug
• • 时间处理有时区问题
• • 数据丢失风险（并发写入）
• • 无法持久化

Hermes Agent Cron 系统（完整重建）：

功能特性:
  ✓ SQLite 持久化（服务重启不丢失任务）
  ✓ 基于活动的智能超时（正在工作的任务永不超时）
  ✓ 多平台投递（Telegram/Discord/Slack 等）
  ✓ 时区感知（ISO 时间戳处理修复）
  ✓ [SILENT] 静默模式（Agent 可抑制投递）
  ✓ MEDIA 文件作为原生平台附件投递
  ✓ 预执行脚本注入（数据采集/变化检测）
  ✓ 投递失败跟踪
  ✓ 错过执行恢复机制
  ✓ 任务级 provider/model 覆盖

自然语言创建:
  "每天早上 8 点总结昨天的 GitHub PR 并发送到 Telegram"
  "每周日下午汇总本周工作并邮件给我"
  "每小时检查服务器状态，异常时发 Discord 告警"

4.10 RL 训练集成

这是 Hermes Agent 相对 OpenClaw 最具研究价值的差异：

DeepSeek/Kimi/GLM 等）  ✓ 两阶段训练（Phase 1: OpenAI 服务器；Phase 2: VLLM 完整 RL）  ✓ 并行轨迹生成  ✓ 训练数据收集管道" data-show-line-number="false" style="font-size: 90%;border-radius: 4px;display: -webkit-box;padding: 0.5em 1em 1em;overflow-x: auto;text-indent: 0;color: inherit;background: none;white-space: nowrap;margin: 0;">OpenClaw: 无 RL 训练能力

Hermes Agent:
  ✓ Atropos RL 环境框架集成
  ✓ SWE-bench 风格训练环境（HermesSweEnv）
  ✓ TerminalBench 2.0 评测环境（89 任务）
  ✓ 代理策略蒸馏（Agentic OPD）
  ✓ YC-Bench 长视野基准测试
  ✓ 多模型 Tool Call 解析器（Hermes/Mistral/Llama/Qwen/DeepSeek/Kimi/GLM 等）
  ✓ 两阶段训练（Phase 1: OpenAI 服务器；Phase 2: VLLM 完整 RL）
  ✓ 并行轨迹生成
  ✓ 训练数据收集管道

5. 为什么要迁移到 Hermes Agent

5.1 OpenClaw 已停止开发

OpenClaw 不再接受新功能、bug 修复或安全补丁。继续使用意味着：

• • 安全风险：已知漏洞无人修复
• • 兼容性问题：新的 LLM API 变化（如 GPT-5、Claude 4.x）无人适配
• • 缺失新能力：无法使用 MCP、新消息平台、新模型

5.2 Hermes Agent 主动修复了 OpenClaw 的所有已知问题

从 Release Notes 追溯，Hermes Agent 早期版本专门修复了 OpenClaw 遗留的 bug：

5.3 功能差距越来越大

每周 Hermes Agent 都在发版，截至 v0.8.0：

• • v0.2.0（2026.3.12）：70+ 技能，MCP，ACP，3289 测试
• • v0.3.0（2026.3.17）：流式输出，插件系统，原生 Anthropic，智能审批，Voice
• • v0.4.0（2026.3.23）：OpenAI 兼容 API 服务器，6 个新消息平台，4 个新 LLM 提供商
• • v0.5.0（2026.3.28）：HuggingFace，Telegram Private Topics，供应链安全加固
• • v0.6.0（2026.3.30）：Profiles 多实例，MCP 服务端，Docker，Fallback 链，飞书，企微
• • v0.7.0（2026.4.3）：可插拔记忆提供商，凭据池轮转，Camofox 浏览器，内联 Diff 预览
• • v0.8.0（2026.4.8）：背景任务通知，免费 MiMo v2 Pro，实时模型切换，MCP OAuth 2.1

5.4 迁移工具完善

从 v0.3.0 开始，官方提供完整迁移工具：

hermes claw migrate --dry-run  # 先预览，再决定

迁移从未如此简单过。

6. 迁移方法：从 OpenClaw 到 Hermes Agent

步骤一：安装 Hermes Agent

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc  # 或 source ~/.zshrc

支持平台：Linux、macOS、WSL2、Android（Termux）

步骤二：运行迁移命令

方法 A：首次安装时自动迁移
Setup 向导会自动检测 ~/.openclaw 并提示迁移：

hermes setup
# 向导会询问：检测到 OpenClaw，是否迁移配置？

方法 B：手动迁移（安装后任意时间）

# 预览迁移内容（不执行任何操作）
hermes claw migrate --dry-run

# 执行完整迁移
hermes claw migrate

# 仅迁移用户数据（不迁移 API 密钥）
hermes claw migrate --preset user-data

# 覆盖已有冲突
hermes claw migrate --overwrite

方法 C：使用 Agent 引导迁移

hermes
# 在对话中输入：
# "使用 openclaw-migration 技能帮我从 OpenClaw 迁移"

迁移内容一览

验证迁移

hermes doctor          # 健康检查
hermes model           # 确认 LLM 提供商配置
hermes gateway status  # 确认消息平台配置
hermes skills          # 浏览已迁移技能

7. 迁移后的用户需要重新学习什么

命令变化对照表

配置文件位置变化

OpenClaw:
~/.openclaw/config.yaml
~/.openclaw/memory/MEMORY.md
~/.openclaw/skills/

Hermes Agent:
~/.hermes/config.yaml
~/.hermes/memory/MEMORY.md
~/.hermes/skills/
~/.hermes/sessions/        # 新增：SQLite 会话数据库
~/.hermes/logs/            # 新增：结构化日志
~/.hermes/profiles/        # 新增：多实例 Profile

概念变化

8. 已知迁移问题与解决方案

问题 1：迁移覆盖了 model config

症状：迁移后模型配置被覆盖为字符串而非字典
原因：v0.6.0 之前的迁移 bug（#3924^[2]）
解决：确保使用 v0.6.0+ 版本（hermes update 升级到最新）

hermes update
hermes model  # 重新选择模型

问题 2：Setup 向导覆盖自定义端点

症状：迁移后自定义 API 端点配置丢失
原因：v0.7.0 之前的 setup 向导 bug（#4180^[3]）
解决：使用最新版本，setup 向导已修复不再覆盖自定义配置

问题 3：技能迁移后显示为"不可信"

症状：从 OpenClaw 迁移的技能被标记为不受信任的社区内容
原因：技能信任检测误判（已在 v0.5.0 修复）
解决：

hermes update
# 重新安装技能或在对话中确认信任

问题 4：Gateway 启动失败（systemd 权限）

症状：hermes gateway start 失败，提示 systemd 权限错误
解决：

# 检查 systemd 状态
hermes doctor

# 手动配置 linger（headless 服务器）
loginctl enable-linger $USER

# 或使用系统级服务（需 sudo）
hermes gateway install --scope system

问题 5：Anthropic provider 配置失效

症状：从 OpenClaw 迁移的 Anthropic API key 无法使用
解决：Hermes Agent 区分标准 API key（sk-ant-*）和 OAuth token，非 sk-ant- 前缀的 key 需要重新配置：

hermes auth remove anthropic
hermes model  # 重新选择 Anthropic 提供商并输入 key

问题 6：Windows 用户

注意：Hermes Agent 不支持 Windows 原生环境，需要使用 WSL2：

# 安装 WSL2
wsl --install
# 在 WSL2 中运行安装命令

问题 7：MiniMax 模型 404

症状：MiniMax 模型调用返回 404
原因：Anthropic 格式端点自动追加 /v1 导致路径错误
解决：已在 v0.8.0 修复，更新即可：

hermes update

9. 总结

一句话总结

OpenClaw 是原型，Hermes Agent 是生产级系统。

迁移决策矩阵

迁移收益汇总

迁移到 Hermes Agent，你将获得：

✅ 20+ LLM 提供商，包括国内 GLM/Kimi/MiMo（免费）
✅ 10+ 消息平台，一个 gateway 进程全覆盖
✅ 自我学习的技能系统，Agent 越用越强
✅ 安全体系（SSRF/供应链/秘密防护）
✅ MCP 完整支持（客户端 + 服务端）
✅ 多实例 Profiles（工作/个人完全隔离）
✅ 内置 Cron 调度器，自然语言创建定时任务
✅ RL 训练集成（研究用户专属）
✅ 3,289 测试覆盖，生产级稳定性
✅ 官方迁移工具hermes claw migrate，零成本迁移

开始迁移：

# 安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 迁移
hermes claw migrate --dry-run  # 先预览
hermes claw migrate            # 再执行

# 验证
hermes doctor