什么是 Hermes Agent?
Hermes Agent 是一个开源的 AI 代理框架,可以把它理解成一个可以跟你对话、帮你执行任务的 AI 助手。它部署在你的 VPS 上,所有数据都在你自己的服务器里,不经过任何第三方。
核心能力: 聊天对话 / 执行 shell 命令 / 读写文件 / 搜索网页 / 写代码 / 定时任务 / 连接微信机器人远程操控
前置要求
| 项目 | 最低配置 | 推荐配置 |
|---|---|---|
| 服务器 | 1核CPU, 1GB RAM | 2核CPU, 2GB RAM |
| 系统 | Ubuntu 22.04 / Debian 11+ | Ubuntu 24.04 |
| Python | 3.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"
或者使用其他提供商:
| 提供商 | 设置命令 | 说明 |
|---|---|---|
| OpenAI | provider openai / model gpt-4o | 最稳定,需 API Key |
| Anthropic | provider anthropic / model claude-sonnet-4 | 代码能力强 |
| OpenRouter | provider openrouter / model anthropic/claude-sonnet-4 | 聚合多家模型 |
| DeepSeek | provider 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 实战教程》。