Hermes Agent 安装部署教程:从零搭建你的 AI 代理助手

什么是 Hermes Agent?

Hermes Agent 是一个开源的 AI 代理框架,可以把它理解成一个可以跟你对话、帮你执行任务的 AI 助手。它部署在你的 VPS 上,所有数据都在你自己的服务器里,不经过任何第三方。

核心能力: 聊天对话 / 执行 shell 命令 / 读写文件 / 搜索网页 / 写代码 / 定时任务 / 连接微信机器人远程操控

前置要求

项目最低配置推荐配置
服务器1核CPU, 1GB RAM2核CPU, 2GB RAM
系统Ubuntu 22.04 / Debian 11+Ubuntu 24.04
Python3.10+3.12
磁盘5GB 可用空间20GB+(用于存储日志和记忆)
Node.js无需如需 TUI 模式需要 18+

第一步:安装依赖

登录你的 VPS,先更新系统并安装 Python 和 Git:

sudo apt update && sudo apt upgrade -y
sudo apt install -y python3 python3-pip python3-venv git curl

第二步:安装 Hermes Agent

Hermes 的安装非常简洁——一条 pip 命令即可:

pip3 install hermes-agent

如果你的 VPS 有 Python 环境隔离要求(推荐),先用 venv 创建独立环境:

python3 -m venv ~/hermes-env
source ~/hermes-env/bin/activate
pip3 install hermes-agent

验证安装是否成功:

hermes --version

如果输出版本号(如 0.1.15),说明安装完成。

第三步:配置模型提供商

Hermes 需要连接一个 AI 模型才能工作。支持多种提供商:

hermes config set provider openai
hermes config set model gpt-4o
hermes config set api_key "sk-your-api-key-here"

或者使用其他提供商:

提供商设置命令说明
OpenAIprovider openai / model gpt-4o最稳定,需 API Key
Anthropicprovider anthropic / model claude-sonnet-4代码能力强
OpenRouterprovider openrouter / model anthropic/claude-sonnet-4聚合多家模型
DeepSeekprovider deepseek / model deepseek-chat性价比高

配置完成后,测试一下是否能正常对话:

hermes "你好,请用一句话介绍你自己"

如果 Hermes 正常回应,说明配置成功。

第四步:连接到微信(可选但推荐)

接入微信后,你可以在手机上随时给 Hermes 发消息,它帮你执行任务。Hermes 支持通过微信个人号或企业微信机器人连接:

方式一:连接个人微信

Hermes 支持直接对接微信个人号,配置后你给它发消息就能操控。启动微信监听模式:

hermes weixin

方式二:连接企业微信机器人

如果你在用企业微信(WeLink/企微),可以在群聊中拉入 Hermes 机器人,直接在群里发指令。

配置完成后,用微信给 Hermes 发消息试试:

帮我查一下今天服务器状态
帮我写一篇300字的周报摘要
每天早上7点提醒我看AI日报

Hermes 收到消息后会自动处理并回复。

第五步:设置开机自启(让 Hermes 7×24 在线)

创建 systemd 服务文件:

sudo tee /etc/systemd/system/hermes.service << 'EOF'
[Unit]
Description=Hermes Agent Service
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/home/ubuntu
ExecStart=/home/ubuntu/hermes-env/bin/hermes weixin
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

启动并启用服务:

sudo systemctl daemon-reload
sudo systemctl enable --now hermes.service

检查状态:

sudo systemctl status hermes.service

如果显示 active (running),说明 Hermes 已经作为服务在后台运行了。

常见问题

Q:安装时报错 externally-managed-environment

A:Ubuntu 24.04+ 默认阻止 pip 全局安装。两种解决:

  • 使用 venv(推荐):先 python3 -m venv ~/hermes-env 再激活安装
  • --break-system-packages 参数强制安装

Q:Hermes 运行时报 ModuleNotFoundError

A:检查是否在正确的 Python 环境中运行。如果用 venv 安装,执行时要先 source ~/hermes-env/bin/activate

Q:VPS 只有 1GB 内存够吗?

A:够。Hermes 本身只占用约 40-60MB 内存,主要资源消耗是你调用 AI 模型的 API 请求——这部分在云端完成,不占用服务器资源。

下一步

安装完成后,可以尝试:

  • 让 Hermes 创建一个 Notion 页面 → hermes "帮我建一个 Notion 页面记录今天的笔记"
  • 设置定时任务 → 让 Hermes 每天早上汇报服务器状态
  • 安装技能包 → 让 Hermes 学会更多能力(GitHub 管理、数据分析等)

💡 如果你想了解 Hermes 的更多实战用法,可以看看项目区的《Hermes Agent 实战教程》。