← 返回教程列表
☁️ Hermes Agent 云端部署教程
版本：v0.11.0 (v2026.4.23) · 更新于：2026年4月
💡 适合谁？
想在云服务器上 7x24 运行 Hermes Agent、连接多个消息平台（Telegram、Discord、飞书等）的进阶用户。
📋 推荐的云服务器配置
| 配置 | 推荐场景 | 参考价格 |
|---|---|---|
| 1核2G | 单平台运行（如只有 Telegram） | 约50元/月 |
| 2核4G | 多平台 + Skills + MCP | 约80元/月 |
| 4核8G | 商用量、多实例 | 约150元/月 |
🚀 部署步骤（以 Ubuntu 22.04 为例）
1
连接服务器
ssh ubuntu@你的服务器IP
2
安装 Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs git node --version # 确认输出 v20.x
3
克隆 Hermes Agent
git clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent npm install
npm install 可能需要 2-5 分钟，请耐心等待。
4
配置环境
cp config.example.yaml config.yaml nano config.yaml
需要配置的关键项：
- provider：设置你的 LLM API Key（如 OpenAI、Anthropic、DeepSeek）
- platforms：启用需要的消息平台并填写 Bot Token
5
使用 PM2 保持运行
安装 PM2 让 Hermes 在后台持续运行：
sudo npm install -g pm2 pm2 start npm --name hermes -- start pm2 save pm2 startup # 设置为开机自启
📋 PM2 常用命令
| 命令 | 说明 |
|---|---|
pm2 status | 查看运行状态 |
pm2 logs hermes | 查看实时日志 |
pm2 restart hermes | 重启 Hermes |
pm2 stop hermes | 停止 Hermes |
🔐 安全设置
1
配置防火墙（UFW）
sudo ufw allow ssh sudo ufw enable
只开放 SSH 端口，其他端口按需开放。
2
使用环境变量保存敏感信息
不要在 config.yaml 中硬编码 API Key，改用环境变量：
export OPENAI_API_KEY="sk-xxx" export ANTHROPIC_API_KEY="sk-ant-xxx"
然后在 config.yaml 中使用 $OPENAI_API_KEY 引用。
🔄 更新 Hermes Agent
cd ~/hermes-agent git pull origin main npm install pm2 restart hermes
🔧 常见问题
服务运行但平台不响应
检查 config.yaml 中的平台配置：确认 Bot Token 正确、平台已启用。查看日志：pm2 logs hermes
内存占用过高
减少同时启用的平台数量，或者升级服务器配置。
pm2 无法开机自启
运行 pm2 startup 并按提示执行输出中的命令。
📖 下一步
xia007 · 养虾人的导航站