如果你想拥有一个可以 24 小时在线、随时帮你处理任务、连接各种平台的 AI 助手，Hermes Agent 是一个不错的选择。
今天把完整的安装和配置流程整理出来，从环境准备到 Telegram 接入，手把手搞定。
Hermes Agent 是什么
Hermes 是一个开源的 AI Agent 框架，支持接入多种大模型（Claude、GPT 等），可以连接 Telegram、Discord 等消息平台，还能执行代码、操作文件、搜索网页、定时任务等。
官方文档：https://hermes-agent.nousresearch.com/docs
环境要求
最低配置：
– 系统：Ubuntu 20.04 / 22.04（本文以此为准）
– 内存：2GB
– 硬盘：10GB
– Python：3.10+
推荐：
– 4GB+ 内存
– 独享 IP（如果需要接入 Telegram Bot）
第一步：安装 Hermes Agent
方式一：官方推荐安装（新建一个 Linux 用户）
# 创建一个新用户（可选但推荐）
sudo adduser hermes
sudo usermod -aG sudo hermes
# 切换到 hermes 用户
sudo su - hermes
# 安装 Hermes
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
方式二：Python pip 直接安装
pip install hermes-agent
方式三：从源码安装
git clone https://github.com/nousresearch/hermes-agent.git
cd hermes-agent
pip install -e .
本文用方式一演示。
第二步：配置基础信息
安装完成后，需要配置模型和连接方式。
初始化配置：
hermes init
这会在 ~/.hermes/ 目录下生成配置文件。
主要配置文件：
~/.hermes/config.yaml # 主配置
~/.hermes/skills/ # 技能目录
~/.hermes/memories/ # 记忆存储
配置大模型（以 OpenAI 兼容接口为例）：
编辑 ~/.hermes/config.yaml：
model:
provider: openai
name: claude-sonnet-4-6-20250514
api_key: 你的API密钥
base_url: https://us.xclis.ai/v1 # 你的 API 端点
# 可用模型列表（部分）：
# claude-opus-4-6-20250514
# claude-sonnet-4-6-20250514
# gpt-4o
# gpt-4o-mini
telegram:
enabled: true
bot_token: 你的Telegram Bot Token
allowed_users:
- 你的Telegram User ID
skills:
enabled: true
directory: ~/.hermes/skills
第三步：接入 Telegram Bot
Telegram 是 Hermes 最常用的接入平台，手机电脑都能随时用。
创建 Telegram Bot：
- 在 Telegram 搜索
@BotFather - 发送
/newbot - 给 Bot 起名字（比如
My Hermes Assistant） - 给 Bot 起用户名（必须以
bot结尾，比如myhermesbot） - 复制 BotFather 给你的 Token（格式：
123456789:ABCdef...）
获取你的 User ID：
- 在 Telegram 搜索
@userinfobot - 发送
/start - 记录返回的数字 ID（格式：
123456789）
配置 config.yaml：
telegram:
enabled: true
bot_token: "123456789:ABCdefGhIJKlmNoPQRsTUVwxYZ"
allowed_users:
- 735577639 # 你的 Telegram User ID
启动 Hermes：
hermes start
正常启动后，打开 Telegram 找到你的 Bot，发送 /start 即可开始对话。
第四步：使用 Skills（技能系统）
Hermes 的核心能力之一是 Skills，可以理解为插件，让 Agent 调用各种工具和服务。
查看内置技能：
hermes skills list
常用技能：
– terminal：执行 shell 命令
– file：读写文件
– web：搜索网页、获取内容
– browser：浏览器操作
– wordpress-auto-publish：自动发布文章到 WordPress
– jupyter-live-kernel：运行 Python 代码
手动触发技能：
在 Telegram 里发送：
@agent <技能名> <任务描述>
比如：
@agent browse 去搜索一下最新的 AI 新闻
编写自定义技能：
在 ~/.hermes/skills/ 目录下创建 SKILL.md 文件：
# 我的自定义技能
<!--
skill:
name: my-skill
description: 做某件事
triggers: /myskill, 我的技能
-->
第五步：定时任务（Cron Jobs）
Hermes 支持定时执行任务，比如每天早上推送资讯、定时检查服务器状态等。
创建定时任务：
在 Telegram 里发送：
/cron create "0 9 * * *" "给我推送今天的科技新闻"
这会在每天早上 9 点执行任务。
查看定时任务：
/hermes cron list
删除定时任务：
/hermes cron remove <任务ID>
第六步：配置反向代理（可选）
如果服务器在大陆，需要配置代理才能访问 OpenAI 等服务。
在 ~/.hermes/config.yaml 中添加：
proxy:
enabled: true
http: http://127.0.0.1:7890
https: http://127.0.0.1:7890
或者设置环境变量：
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
常用命令
# 启动
hermes start
# 停止
hermes stop
# 查看状态
hermes status
# 查看日志
hermes logs
# 重启
hermes restart
# 更新
hermes update
# 查看配置
hermes config show
# 设置配置项
hermes config set telegram.enabled true
常见问题
Q：启动后提示 “Connection refused”？
A：检查端口是否被占用：lsof -i :3000，或修改配置换一个端口。
Q：Telegram Bot 没有响应？
A：检查 bot_token 是否正确，确保已设置 allowed_users 包含你的 User ID。
Q：模型调用失败？
A：检查 api_key 是否正确，确认服务器能访问 base_url（可能需要配置代理）。
Q：技能不生效？
A：检查技能文件是否放在 ~/.hermes/skills/ 目录下，文件名必须以 .md 结尾。
写在最后
安装和配置 Hermes Agent 其实不难，关键是搞清楚配置文件的位置和格式。建议先从 Telegram 接入开始，熟悉基本操作后再逐步解锁更多功能。
有什么问题可以随时交流。