Hermes Agent 安装配置全指南:从 OpenClaw 迁移到新一代 AI 代理

前言

在 OpenClaw 之后,新一代开源 AI 代理框架 Hermes Agent 走进了我们的视野。作为从 OpenClaw 演变而来的项目,Hermes 保留了原有的设计理念,同时在架构、技能系统和可扩展性上做出了诸多改进。

本文将详细记录 Hermes Agent 的安装、配置过程,以及从 OpenClaw 迁移的完整步骤,帮助你快速搭建属于自己的新一代私人 AI 助手。

Hermes Agent 架构概览

baoyu-danger-gemini-web “请生成一张现代且清晰的技术软件架构图,用来展示Hermes Agent的核心组件。图像中心是一个标有’Python Core’的中央枢纽,从这个枢纽向外延伸出四个分支,分别连接到四个代表不同模块的图标区域:1. ‘Skill System’ (使用Markdown文档的图标), 2. ‘Memory Module’ (使用大脑或数据库的图标), 3. ‘Telegram Interface’ (使用聊天气泡的图标), 4. ‘Sub-agents’ (使用多个小型机器人的图标)。图表应该使用极简主义的矢量风格,线条流畅,背景为干净的白色或浅灰,使用科技蓝作为主色调,整体风格类似专业的SaaS产品白皮书插图。”


什么是 Hermes Agent

Hermes Agent 是一个基于 Python 的开源 AI 代理框架,继承了 OpenClaw 的核心思想:在你的服务器上运行一个持久化的 AI 助手,通过 Telegram 等平台随时访问

相比 OpenClaw (TypeScript),Hermes 的主要特点:

特性 OpenClaw Hermes Agent
语言 TypeScript Python
技能系统 插件式 原生 markdown 技能,易于编写和分享
子代理 有限支持 一流的委派支持,可同时运行多个子任务
定时任务 内置 通过 cronjob 工具原生支持
生态系统 闭包插件架构 开放技能仓库,社区共享

💡 如果你之前一直在使用 OpenClaw,迁移到 Hermes Agent 非常顺畅,官方提供了自动化迁移工具,可以一键导入 OpenClaw 的配置和记忆。

Hermes VS OpenClaw 对比图

baoyu-danger-gemini-web “请生成一张直观的双栏对比信息图,用于对比OpenClaw和Hermes Agent。左侧代表OpenClaw,主色调为稍显陈旧的灰色,中心是TypeScript语言的Logo,并用一个封闭、带锁的盒子来隐喻其封闭的插件系统。右侧代表Hermes Agent,主色调为明亮活泼的蓝色,中心是Python语言的Logo,并用多个散开的、发光的Markdown文档图标来隐喻其开放、易于分享的技能系统。图片应该具有现代网页设计的质感,对比强烈,让人一眼看出右侧系统的开放性优势。”


环境准备

Hermes Agent 需要以下基础环境:

  • Linux 系统 (推荐 Ubuntu 22.04+/Debian 12+)
  • Python 3.10+
  • Git
  • 网络连接 (用于拉取代码和访问 AI API)

如果你已有 OpenClaw 在运行,可以直接在同一台机器上安装 Hermes,不会产生冲突。


安装步骤

1. 克隆源码

1
2
git clone https://github.com/clawed-ai/hermes-agent.git
cd hermes-agent

2. 运行安装

1
./install.sh

安装脚本会自动:

  • 创建必要的目录结构
  • 安装 Python 依赖
  • 生成配置文件

3. 首次配置

安装完成后运行 setup 向导:

1
./bin/hermes setup

从 OpenClaw 迁移

如果你之前安装过 OpenClaw,setup 向导会自动检测到 ~/.openclaw 目录,并询问是否迁移:

  • 自动导入 SOUL.md 性格设定
  • 自动导入记忆文件到 ~/.hermes/memories/
  • 自动导入技能到 ~/.hermes/skills/openclaw-imports/
  • 转换模型配置到 Hermes 格式

整个迁移过程完全自动化,几分钟就能完成。

迁移向导截图

baoyu-danger-gemini-web “请生成一张模拟复古计算机终端界面(CLI)的插图。图像主体是一个黑色的命令行窗口,里面显示着绿色的等宽字体。文字内容需要模拟一个安装向导的输出,隐约可见’Hermes Agent Setup…’、’Found legacy OpenClaw installation.’、’Migrate memories and skills? [Y/n]’等字样。光标在一个方括号后闪烁。整个画面应该带有轻微的CRT显示器扫描线效果和发光效果,营造出极客和开发者的氛围。”

4. 配置模型 API

Hermes 支持多种模型服务商,在 setup 过程中根据提示填入 API Key 即可:

  • 火山引擎 (Volcengine/Ark) - 豆包模型
  • 阿里百炼 (DashScope/Bailian) - 通义千问
  • OpenAI - GPT-4o 系列
  • Anthropic - Claude 系列
  • OpenRouter - 聚合多家模型

我的配置参考:

1
2
3
models:
default:
primary: bailian/ark-code-latest

配置 Telegram 机器人

Hermes 主要通过 Telegram 交互,配置步骤:

  1. @BotFather 创建新机器人,获取 Bot Token
  2. ~/.hermes/config.yaml 中填入 Telegram 配置:
1
2
3
4
5
telegram:
enabled: true
bot_token: "你的Bot Token"
allowFrom:
- 你的Telegram用户ID
  1. 重启 Hermes 即可生效

Telegram 机器人配置

baoyu-danger-gemini-web “请生成一张说明如何将AI代理连接到Telegram的示意图。画面左侧是一个醒目的Telegram官方纸飞机Logo,右侧是一个代表服务器或AI大脑的发光图标。两者之间有一条发光的数据线相连。在数据线的上方,悬浮着一个半透明的深色代码窗口,里面用YAML格式高亮显示两行关键代码:’bot_token: *******’ 和 ‘allowFrom: [User_ID]’。整体风格要求扁平化、现代感,使用蓝白配色,能够直观传达’配置通讯接口’的概念。”


技能系统

Hermes 的技能系统是其最大亮点。技能以标准 markdown 文件存储 (SKILL.md),易于阅读、修改和分享。

安装第三方技能

baoyu-skills 为例:

1
git clone https://github.com/jimliu/baoyu-skills ~/.hermes/skills/baoyu-skills

就这么简单,克隆完就能用。baoyu-skills 提供了很多实用技能:

技能 功能
baoyu-imagine AI 图像生成 (支持多家服务商)
baoyu-comic 生成漫画
baoyu-translate 翻译文章
baoyu-youtube-transcript 获取 YouTube 字幕
baoyu-url-to-markdown 网页转 Markdown
baoyu-slide-deck 生成幻灯片
baoyu-post-to-x/weibo/wechat 发布文章到社交平台

baoyu-skills 需要 Bun 运行 TypeScript,安装也很简单:

1
2
3
4
# 如果没有 bun,npx 会自动处理
npm install -g bun
# 或者
curl -fsSL https://bun.sh/install | bash

baoyu-skills 技能展示

baoyu-danger-gemini-web “请生成一张展示多种AI技能插件集的网格布局插图。画面由六个排列整齐的正方形卡片组成,每个卡片代表一个不同的功能,包含精美的3D小图标:卡片1是画笔和调色板(代表AI图像生成);卡片2是漫画书(代表漫画创作);卡片3是带有’A’和’文’的翻译符号(代表翻译);卡片4是带有播放键的视频框(代表视频字幕提取);卡片5是网页变成文档的过程(代表网页转Markdown);卡片6是幻灯片演示(代表PPT生成)。整体设计应该像是一个现代化的应用商店界面,UI质感丰富,色彩明快高级。”


运行与管理

Hermes 使用 systemd 管理进程,安装完成后自动注册服务:

1
2
3
4
5
6
7
8
9
10
11
# 查看状态
systemctl --user status hermes

# 启动
systemctl --user start hermes

# 停止
systemctl --user stop hermes

# 重启
systemctl --user restart hermes

开启开机自启:

1
systemctl --user enable hermes

定时任务

Hermes 内置了 cronjob 工具,可以创建定时任务,比如:

  • 每日日记报告
  • 每日 GitHub 项目推荐
  • 每月显卡价格报告
  • 服务器监控

创建定时任务示例:

1
hermes cron create --schedule "0 21 * * *" --name "daily-diary" "请生成今日日记并发送给我"

比 OpenClaw 的 cron 系统更灵活,支持直接在对话中创建和管理。


从 OpenClaw 迁移后的清理

迁移完成并验证一切正常后,可以清理 OpenClaw 残留文件:

1
2
# 确认没问题后执行
rm -rf ~/.openclaw

我本次迁移后释放了 867MB 磁盘空间。


使用体验总结

经过几天的使用,Hermes Agent 相比 OpenClaw 的优势:

  1. 技能更开放 - 每个技能都是一个 markdown 文件,查看和修改都非常方便
  2. 子代理更强 - 天生支持委派任务给多个子代理并行处理
  3. 社区生态 - 技能可以直接从 GitHub 克隆使用,比如 baoyu-skills 开箱即用
  4. 记忆持久化 - 内存系统设计更清晰,便于查找和整理

如果你本来就是 OpenClaw 用户,迁移成本非常低,值得一试。


常见问题

Q: Hermes 和 OpenClaw 可以同时运行吗?

A: 可以,它们使用不同的目录和端口,只要 Telegram Bot Token 不冲突就行。

Q: 迁移后原 OpenClaw 的定时任务会自动转过来吗?

A: 目前迁移工具只迁移配置和记忆,定时任务需要手动重建,不过操作很简单。

Q: 支持哪些平台?

A: 目前主要支持 Telegram,网关模式支持网页访问。


💭 从 OpenClaw 到 Hermes,不仅仅是项目的迭代,更是开源 AI 代理思路的进化。不变的是,我们依然拥有一个完全自己掌控的私人 AI 助手,数据掌握在自己手里,想怎么折腾就怎么折腾。


📅 写于 2026年4月13日