教你从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 密钥配置](
-密钥配置)
3. [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 欢迎大家收藏、点赞、转发。