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

前言

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

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

什么是 Hermes Agent

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

相比 OpenClaw (TypeScript)，Hermes 的主要特点：

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

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

环境准备

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 格式

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

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 即可生效

技能系统

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

运行与管理

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日