11 min read

教你从0部署 Hermes Agent,最新 ai 自动化 Agent,币圈和 ai 圈神器

Source: http://x.com/i/article/2047153481568727040

最近花了不少时间折腾 Hermes Agent,走了挺多弯路,终于把它跑起来了,出一期完整的部署视频。

先说为什么做这个。

最近这段时间能看到一个趋势:币安出了 Skills,Surf 也有自己的 Skill,前两个小时 GMGN 也放出了完整的 Skills 接口代码。

从大平台到打狗的工具,基本都在往这个方向走。所以 AI + 自动化操作这件事,对普通人来说我觉得还是有必要去学一下的,早一点点上车没坏处🤔

Hermes 其实和之前那个小龙虾 (Open Claw) 是一个类型的东西,都是社区开源的自动化 Agent。小龙虾最近有点熄火了,我感觉它有些地方做得还不是特别全面。而 Hermes 目前和币圈相性比较好,已经有挺多人在上面做了很优秀的监控和自动化交互脚本。

我自己不是程序员出身,也不是计算机出身,中间确实踩了非常多的坑。但最后我整理了一下,其实核心就是两个模型 + 一个 VPS + 两个软件:

· Claude:本地开发、调试、问问题用的,相当于随身的程序员朋友

· MiniMax(我用的是 2.7):对接到电报里的那个 Hermes,因为 Claude 比较贵,MiniMax 便宜很多,是我目前找到性价比最高的组合

· VPS:我没用腾讯云阿里云这些,玩币圈的话个人觉得还是别和国内厂商沾边,我用的是一家海外的,相对便宜

· Termius:连 VPS 用的,比 Mac 自带终端顺手很多 · VS Code:用来跑 Claude Code,本地开发的入口。

整个流程我是这样走的:

在 VS Code 里跟 Claude 说"我准备在 VPS 上安装 Hermes Agent,不懂脚本,担心被黑客攻击,请帮我做好安全防范一步步安装",然后哪里不会点哪里,基本就是把 Claude 当成一个不会嫌我烦的程序员朋友在用。

可能有些问题站在程序员角度看挺智障的,但我觉得浪费点 token 没事,总比把真人朋友的耐心耗完强😂

走通之后我让 Claude 帮我把完整流程整理成了一份安装指南,从准备工作、密钥配置、VPS 安全加固到最后部署,每一步都有。如果你完全跟不下来,就直接把这份手册整个复制给 Claude,让它照着一步步带你,哪里卡住点哪里,基本上都能搞定。

最后跑起来的效果是这样:

在 Termius 里我连着的是 MiniMax 2.7,发一句"你好",它会回"你好墨染,有什么我可以帮你的"(这是我自己设定的)。

但每次开 Termius 终端比较麻烦,所以下一步就是把它部署到电报里,在电报里和它对话,效果完全一样。

这样实现的一件事就是:只要带着手机,给它发指令,它就能立刻在你 VPS 上执行。

然后你可以把前面提到的币安 Skills、Surf Skills、GMGN Skills 直接扔给它,告诉它你想做什么,它就能帮你去搞——自动监控土狗、自动交易土狗、甚至自动交易预测市场,这些都能让 Hermes 替你去实现。

本期视频我没怎么讲具体的按键操作,光讲思路和大方向就十五分钟了,所以它更像是一期总纲。

具体像 VS Code 怎么绑 Claude、Termius 怎么连 VPS、VPS 怎么买怎么选国家、MiniMax API 怎么对接,这些细节我觉得相对简单,后面会再单独出视频讲。

这东西没有特别简单,但也真没想象中那么难,跟着走就行。

完整视频+我整理的部署手册.md 已经放出来了,直接甩给 Claude Code 也能完美安装。

# Hermes Agent 完整安装指南 > 适用系统:Ubuntu 24.04 LTS | VPS 环境 | Telegram 接入

--- ## 目录 1. 准备工作

2. [SSH 密钥配置](

#二ssh

-密钥配置)

3. [VPS 安全加固](

#三vps

-安全加固)

4. [安装 Hermes Agent](

#四安装

-hermes-agent)

5. [配置 AI 模型 API](

#五配置

-ai-模型-api)

6. [配置 Telegram Bot](

#六配置

-telegram-bot)

7. 设置开机自启

8. 常用命令速查

9. 常见问题排查

--- ## 一、准备工作 ### 你需要准备的东西 | 项目 | 说明 |

|------|------|

| VPS 服务器 | Ubuntu 22.04/24.04,推荐 1GB+ 内存 |

| SSH 客户端 | 推荐 Termius(支持密钥管理) |

| AI API Key | MiniMax、OpenRouter、OpenAI 等任选其一 |

| Telegram 账号 | 用于创建 Bot 和接收消息 | ### 推荐的 AI 提供商 | 提供商 | 特点 | 获取地址 |

|--------|------|---------|

| MiniMax(推荐) | 国内可访问,有免费套餐 | platform.minimaxi.com |

| OpenRouter | 支持 200+ 模型,有免费额度 | openrouter.ai |

| OpenAI | 稳定,按量计费 | platform.openai.com |

--- ## 二、SSH 密钥配置 > 这一步是为了安全登录 VPS,避免被黑客暴力破解密码。

### 步骤 1:在 Termius 生成 SSH 密钥 ```text Termius → 左侧 Keychain(钥匙图标) → 右上角 + → New Key → 类型选 ED25519 → 名称填 hermes-vps → 点 Generate → Save


点击刚创建的密钥 → Export Public Key → 复制内容

公钥内容格式如下(以 ssh-ed25519 开头): **\### 步骤 3:将公钥上传到 VPS** ```text
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... hermes-vps

用密码登录 VPS,执行以下命令(把 `粘贴你的公钥内容` 替换成真实公钥):

bash
mkdir -p ~/.ssh && chmod 700 ~/.ssh
echo "粘贴你的公钥内容" >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
cat ~/.ssh/authorized_keys   # 验证内容是否正确

✅ 成功标志:`cat` 显示一行以 `ssh-ed25519` 开头的长字符串 ### 步骤 4:配置 Termius 使用密钥登录 ```text Termius → Hosts → 找到你的 VPS → 编辑 → Credentials 区域:清空密码字段 → Keys 选择 hermes-vps → 保存,重新连接


✅ 成功标志:不输密码就能登录

**\--- \## 三、VPS 安全加固** \> 安全加固包括:创建专用用户、配置防火墙、安装入侵检测。

**\### 步骤 1:上传安全脚本**

在****本机终端****执行(使用 Termius SFTP 也可以):

```text
bash
scp 01_security_hardening.sh root@你的VPS_IP:/root/

或直接用 Termius SFTP 拖拽上传。

### 步骤 2:以 root 运行安全加固脚本 ```text bash bash /root/01_security_hardening.sh


脚本会自动完成以下操作:

| 操作 | 说明 |

| 创建 \`hermesadmin\` 用户 | 专用非 root 账户,日常操作用此账户 |

| 禁用 root SSH 登录 | 防止直接攻击 root |

| 禁用密码登录 | 只允许密钥登录 |

| 配置 UFW 防火墙 | 只开放 SSH(22) 端口 |

| 安装 Fail2ban | SSH 3次失败自动封禁24小时 |

| 开启自动安全更新 | 自动安装系统安全补丁 |

| 加固内核参数 | 防止网络攻击 |

**\### ⚠️ 重要:运行脚本前必须先完成密钥配置!**

脚本运行后会禁用密码登录,如果还没配置密钥,你将无法再登录 VPS。

**\### 步骤 3:将公钥复制给 hermesadmin**

安全脚本运行后,在当前 root 会话中执行:

```text
bash
mkdir -p /home/hermesadmin/.ssh
cp /root/.ssh/authorized_keys /home/hermesadmin/.ssh/
chown -R hermesadmin:hermesadmin /home/hermesadmin/.ssh
chmod 700 /home/hermesadmin/.ssh
chmod 600 /home/hermesadmin/.ssh/authorized_keys
``` **\### 步骤 4:用 hermesadmin 新建连接** ```text

Termius → Hosts → + → New Host
→ Address: 你的VPS_IP
→ Username: hermesadmin
→ Password: 留空
→ Keys: hermes-vps
→ 保存并连接

✅ 成功标志:显示 `hermesadmin@你的主机名:~$` ## 四、安装 Hermes Agent

> 以下操作全部在 hermesadmin 账户下执行。

### 步骤 1:上传安装脚本

通过 Termius SFTP 将以下文件上传到 `/home/hermesadmin/`:

- `02_install_hermes.sh` - `03_setup_telegram.sh` - `04_setup_service.sh` ### 步骤 2:运行安装脚本

bash
bash ~/02_install_hermes.sh

安装器会自动安装所有依赖(Python 3.11、Node.js v22、uv 等),需要 2-5 分钟。

### 步骤 3:安装向导

安装完成后会自动进入设置向导:


How would you like to set up Hermes?
→ ● Quick setup(选这个,按 Enter)
○ Full setup

--- ## 五、配置 AI 模型 API

### 以 MiniMax 为例(推荐国内用户) #### 获取正确的 API Key > ⚠️ MiniMax 有两种 Key,必须用对:

| Key 类型 | 用途 | 位置 |

|---------|------|------|

| 接口密钥(sk-api-...) | 按量计费使用 | 账户管理 → 接口密钥 |

| Token Plan Key(sk-cp-...) | 订阅套餐使用 | 套餐管理 → Token Plan |

如果你购买了 Token Plan 套餐,必须使用 Token Plan Key(sk-cp-...) #### 配置步骤

在 VPS 终端运行:

bash
hermes setup

在向导中:

1. 选择 MiniMax (global direct API)

2. 粘贴你的 Token Plan Key(`sk-cp-...`)

3. Base URL 填写:` https://api.minimaxi.com/v1

` #### 验证 API Key 是否有效 ```text bash curl -X POST https://api.minimaxi.com/v1/text/chatcompletion_v2
-H "Authorization: Bearer 你的sk-cp-密钥"
-H "Content-Type: application/json"
-d '{"model":"MiniMax-M2.7","messages":[{"role":"user","content":"hi"}]}'


✅ 成功:返回包含 \`"finish_reason":"stop"\` 的 JSON

❌ 失败:返回 \`{"base_resp":{"status_code":2049,"status_msg":"invalid api key"}}\` **\#### 启动 Hermes 测试**

```text
bash
hermes

输入"你好",如果 Hermes 正常回复,说明模型配置成功。

---

## 六、配置 Telegram Bot

### 步骤 1:创建 Telegram Bot 1. 打开 Telegram,搜索 @BotFather

2. 发送 `/newbot` 3. 输入 Bot 显示名称(如:`Hermes AI`)

4. 输入 Bot 用户名(必须以 bot 结尾,如:`my_hermes_bot`)

5. 保存 BotFather 给你的 Token,格式如:


1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
``` **\### 步骤 2:获取你的 Telegram 用户 ID** 1\. 搜索 ****@userinfobot****

2\. 发送 \`/start\` 3\. 记下你的用户 ID(纯数字,如:\`123456789\`) **\### 步骤 3:运行 Telegram 配置**

在 Hermes 终端内输入:

```text

/exit

退出后运行:

bash
hermes gateway setup

按向导填入:

- Bot Token(从 BotFather 获取)

- 授权用户 ID(你的 Telegram 用户 ID)

- Home channel ID(可以填你的用户 ID,或直接回车跳过) ### 步骤 4:选择服务类型 ```text

Choose how the gateway should run: ○ User service → ● System service(选这个,开机自启) ○ Skip **\### 步骤 5:启用用户服务持久化**text bash sudo loginctl enable-linger hermesadmin **\### 步骤 6:安装并启动 Gateway**text bash hermes gateway install hermes gateway start


打开 Telegram,向你的 Bot 发送消息。

✅ 成功标志:Bot 正常回复

**\--- \## 七、设置开机自启**

验证服务状态:

```text
bash
systemctl --user status hermes-gateway

✅ 成功输出:


● hermes-gateway.service - Hermes Agent Gateway
Active: active (running) ...
...enabled...

--- ## 八、常用命令速查 ### Hermes 日常操作 | 命令 | 说明 |

| `hermes` | 启动 Hermes 终端 |

| `hermes setup` | 重新配置(API Key、模型等) |

| `hermes model` | 查看/切换模型 |

| `hermes gateway start` | 启动 Telegram 网关 |

| `hermes gateway install` | 安装为系统服务 |

| `hermes doctor` | 诊断问题 |

| `hermes doctor --fix` | 自动修复问题 | ### 服务管理 | 命令 | 说明 |

| `systemctl --user status hermes-gateway` | 查看服务状态 |

| `systemctl --user restart hermes-gateway` | 重启服务 |

| `systemctl --user stop hermes-gateway` | 停止服务 |

| `journalctl --user -u hermes-gateway -f` | 实时查看日志 | ### Telegram Bot 命令 | 命令 | 说明 |

| `/new` | 开启新对话 |

| `/reset` | 重置当前对话 |

| `/model` | 切换模型 |

| `/skills` | 查看可用技能 |

| `/help` | 查看帮助 |

--- ## 九、常见问题排查 ### ❓

`hermes: command not found`

bash
source ~/.bashrc
# 或
export PATH="$HOME/.local/bin:$PATH"

### ❓ SSH 服务名不对(`sshd.service not found`)

Ubuntu 上 SSH 服务名是 `ssh` 不是 `sshd`:
bash
systemctl reload ssh # 不是 systemctl reload sshd

### ❓ MiniMax API Key 无效(401 错误)

检查以下几点:

1. 有 Token Plan 套餐 → 必须用 `sk-cp-...` 开头的 Token Plan Key

2. 无套餐按量计费 → 用 `sk-api-...` 开头的接口密钥

3. Base URL 必须是 ` https://api.minimaxi.com/v1

`(注意是 minimaxi 不是 minimax)

### ❓ Telegram Bot 没有回复

bash
# 检查 gateway 是否在运行
systemctl --user status hermes-gateway
# 如果没运行,手动启动
hermes gateway start
# 查看错误日志
journalctl --user -u hermes-gateway -n 50

### ❓ scp 上传文件时提示 Permission denied

原因:密码登录已禁用,需要用密钥或 Termius SFTP 上传。

解决:用 Termius 顶部的 SFTP 标签直接拖拽上传文件。

## 安全架构总览 你的 Telegram

▼ (HTTPS 出站长轮询)

Telegram 服务器

▼

hermes-gateway 服务 (VPS 上)

▼

Hermes Agent

▼

MiniMax API ( https://api.minimaxi.com/v1 )

VPS 防护层:

│ UFW 防火墙(只开放 SSH 22端口) │

│ Fail2ban(暴力破解防护) │

│ hermesadmin(非 root 用户) │

│ SSH 密钥登录(禁用密码) │

Hermes 使用出站长轮询连接 Telegram,不需要开放任何额外入站端口,安全性极高。

如果还是不懂,可以看我的油管视频: https://www.youtube.com/watch?v=eg6dw3eBoAU 会员小群可以咨询博主电报: @moranweb3 或者机器人: @moranweb3bot 欢迎大家收藏、点赞、转发。