### [Hermes Agent 本地部署实战：从安装到 Telegram 控制（含完整踩坑记录）](https://blog.20115.net/article/134)

**Published:** 2026-06-04T10:13:06

**Author:** 王道博客

**Excerpt:** 如果你最近在折腾 AI Agent，大概率已经听说过 OpenClaw。但这几天我实际体验下来，发现一个更有意思的方向——Hermes Agent。它不仅是一个 Agent，更像一个可以持续进化的 AI 个体。 这篇文章，我不讲概念，直接带

如果你最近在折腾 AI Agent，大概率已经听说过 OpenClaw。但这几天我实际体验下来，发现一个更有意思的方向——**Hermes Agent**。它不仅是一个 Agent，更像一个可以持续进化的 AI 个体。

这篇文章，我不讲概念，直接带你完整走一遍：从安装，到接入 Telegram，再到解决一个”几乎所有人都会踩”的坑！

* * *

## 一、Hermes Agent 是什么？

**Hermes Agent** 是由 **Nous Research** 打造的一个自学习 AI Agent，它的核心特点是：

-   🔁 内置学习循环（会成长）
-   🧠 支持长期记忆
-   🔄 支持多模型切换
-   ☁️ 可以在云端运行
-   📱 支持 Telegram / 自动化控制

> 💡 简单说一句：它不是一个工具，而是一个”**会成长的 AI**“。

* * *

## 🛠 二、安装 Hermes（快速流程）

安装过程本身不复杂，核心步骤如下，但需要区分不同的系统：

### 1️⃣ Windows 一键安装命令

```
# Powershell（管理员权限运行）
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
```

### 2️⃣ Mac/Linux/WSL2 一键安装命令

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

### ⚙️ 安装过程中的关键选择

| 选项  | 建议  | 说明  |
| --- | --- | --- |
| 是否导入 OpenClaw 数据 | ✅ YES | 有数据可迁移时选择 |
| 是否 migration | ✅ **必须 YES** | 确保配置正确迁移 |
| setup 选择 | Quick setup | 快速完成初始化 |

* * *

## 📱 Telegram 接入（关键步骤）

在 setup 过程中，你可以选择：**Telegram**（强烈推荐）

### 配置流程：

1.  打开 Telegram，搜索 **@BotFather**
2.  创建新 Bot，获取 **Token**
3.  将 Token 填入 Hermes 配置
4.  完成安全配置

### 🔐 安全配置建议

```
Allowed user ID = <你的Telegram用户ID>
```

> 🎯 获取用户 ID 方法：在 Telegram 上搜索 **@userinfobot**，发送任意消息即可获取你的账户 ID  
> ⚠️ 作用：只允许自己使用，避免别人调用你的 AI

* * *

## ⚠️ 三、最大坑：Telegram 没反应？

> 🚨 很多人（包括我）会卡在这里：
> 
> -   Telegram 发消息
> -   完全没有任何回复 😰

### 🔍 常见错误表

| 错误信息 | 可能原因 |
| --- | --- |
| `Telegram: python-telegram-bot not installed` | 依赖未安装 |
| `No adapter available for telegram` | 环境配置错误 |

### 🎯 本质原因

❌ **不是没安装依赖**  
✅ **是装错环境！**

```
Hermes 使用的是：
  └── 自己的虚拟环境（venv）

而不是：
  └── 你系统的 Python / conda
```

* * *

## ✅ 四、正确解决方案（关键）

### 第一步：找到 Hermes 环境

```
# Windows
cd $env:LOCALAPPDATA\hermes\hermes-agent

# 你会看到：
# 📁 venv/
```

### 第二步：给 Hermes 的 Python 安装依赖

```
# 激活虚拟环境中的 Python
.\venv\Scripts\python.exe -m ensurepip
.\venv\Scripts\python.exe -m pip install python-telegram-bot
```

### 第三步：验证安装

```
hermes doctor
```

✅ 看到输出：

```
✓ python-telegram-bot
```

### 第四步：启动 gateway

```
hermes gateway
```

* * *

### 🔄 Telegram 无法连接的完整解决步骤

```
# 1️⃣ 进入安装目录
cd $env:LOCALAPPDATA\hermes\hermes-agent

# 2️⃣ 安装 pip 和 telegram 依赖
.\venv\Scripts\python.exe -m ensurepip
.\venv\Scripts\python.exe -m pip install --upgrade pip
.\venv\Scripts\python.exe -m pip install python-telegram-bot

# 3️⃣ 在新窗口启动 gateway
hermes gateway
```

🎉 看到对接成功日志，即可正常使用！

* * *

## 🧪 五、测试 Telegram 控制

1.  打开 Telegram，找到你创建的 Bot
2.  发送消息：`hello`
3.  如果正常：
    -   ✅ AI 会直接回复你
    -   ✅ 终端也会输出对应日志

* * *

## ⚖️ 六、Hermes vs OpenClaw（关键区别）

| 对比项 | OpenClaw | Hermes |
| --- | --- | --- |
| **UI** | Web 面板 | ❌ 无 UI |
| **使用方式** | 点网页操作 | 聊天 / 自动运行 |
| **记忆能力** | 弱   | ✅ 强 |
| **学习能力** | 无   | ✅ 有（自学习） |
| **模型切换** | 一般  | ✅ 非常灵活 |
| **部署方式** | 本地为主 | 云端/本地均可 |

> 💬 一句话总结：**OpenClaw 是工具，Hermes 是”会成长的 AI”**。

* * *

## 🚀 七、Hermes 的真正优势

> ❓ 很多人会问：”为什么它没有 UI？”

**其实这是设计理念：AI 不应该被困在网页里。** 🎯

### Hermes 的核心能力：

```
🔄 常驻运行    → 7×24 小时待命
⚡ 随时调用    → Telegram/CLI 即时交互
🗣️ 像人一样交互 → 自然语言对话，无需点击
```

### 🤖 Hermes Agent 给我的感觉：

| 不是  | 而是  |
| --- | --- |
| ❌ “更强的工具” | ✅ “下一代形态” |

### 🔑 它最大的不同：

-   📚 **会学习**：内置反馈循环，越用越聪明
-   🧠 **会记忆**：长期记忆支持上下文理解
-   ⏱️ **可长期运行**：适合自动化任务
-   🌐 **可远程控制**：Telegram/CLI 随时调用

* * *

## 🔮 你可以继续探索：

```
# 🔄 多模型切换（支持 OpenRouter 等）
# ⏰ 自动任务调度（cron 集成）
# 🤝 多 Agent 协作网络
# 📦 自定义工具插件开发
```

> 💡 如果你正在做 **AI 内容创作** 或 **自动化工作流**，这套工具非常值得深入挖掘。

* * *

## 📋 附录：常用命令速查

```
# 🔧 安装/更新
hermes update

# 🩺 健康检查
hermes doctor

# 🚪 启动网关（Telegram 接入）
hermes gateway

# 🧹 清理缓存
hermes clean

# 📖 查看日志
hermes logs --follow
```

* * *

> ⚠️ **免责声明**：本文基于个人实战经验整理，项目仍在快速迭代中，具体命令请以 官方文档 为准。
> 
>  **官方仓库**：https://github.com/NousResearch/hermes-agent  
> 🔗 **Nous Research**：https://nousresearch.com

**Tags:** aiagent, Hermes, OpenClaw, 龙虾

**Categories:** AI智能体

---