【零基础部署】Ubuntu 部署 Hermes Agent 保姆级教程

Hermes Agent 是一个开源的 AI Agent 框架支持连接飞书、Telegram、Discord 等多种平台可以帮你自动化处理各种任务。本文手把手带你从零开始在 Ubuntu 上部署 Hermes Agent全程保姆级跟着走就行。1. 环境准备1.1 系统要求操作系统Ubuntu 22.04 或 24.04推荐 LTS 版本内存至少 2 GB RAM磁盘空间至少 5 GB 可用空间网络需要能访问外网下载依赖和模型 API1.2 更新系统先确保系统是最新的避免后续安装出问题sudo apt update sudo apt upgrade -y2. 安装 Hermes AgentHermes Agent 提供了一键安装脚本非常方便。直接执行以下命令curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装过程会自动下载必要的依赖耐心等待即可。安装完成后需要刷新终端环境source ~/.bashrc验证安装是否成功hermes --version如果输出版本号如hermes 0.x.x说明安装成功了。3. 初始化配置3.1 运行 setup 向导Hermes Agent 提供了交互式的配置向导引导你完成基础设置hermes setup向导会依次询问你以下信息AI 模型提供商选择你要使用的 LLM 提供商如 OpenAI、Anthropic、OpenRouter 等API Key输入对应提供商的 API 密钥默认模型选择一个默认使用的模型3.2 手动修改配置可选如果你想手动调整配置可以直接编辑配置文件hermes config这会打开配置文件你可以按需修改模型、温度、最大 Token 数等参数。4. 启动 Gateway 服务Gateway 是 Hermes Agent 的核心服务负责处理消息和调度任务hermes gateway run启动后终端会显示服务运行日志。如果想让服务在后台持续运行可以使用hermes gateway run 或者配合screen/tmux使用。5. 连接飞书可选如果你想让 Hermes Agent 接入飞书需要完成以下步骤5.1 创建飞书应用登录飞书开放平台https://open.feishu.cn/创建一个自建应用开启机器人能力配置事件订阅和权限获取 App ID 和 App Secret5.2 配置 Hermes 连接飞书在 Hermes 配置中填入飞书应用的信息然后启动 Gatewayhermes gateway run5.3 配对确认首次连接时需要进行配对确认hermes pairing approve feishu 配对码配对成功后你就可以在飞书里和 Hermes Agent 对话了。6. Dashboard 面板可选Hermes Agent 还提供了一个 Web Dashboard可以可视化管理配置和查看日志。6.1 构建前端cd ~/.hermes/hermes-agent/web npm install npm run build6.2 启动 Dashboardhermes dashboard启动后浏览器访问http://localhost:9119即可打开面板。7. 常用命令速查命令作用hermes --version查看版本号hermes setup运行初始化向导hermes config编辑配置文件hermes gateway run启动 Gateway 服务hermes dashboard启动 Web 面板hermes pairing approve feishu 码配对飞书hermes skills查看已安装的技能8. 常见问题Q安装脚本下载很慢怎么办可以尝试使用代理或者手动下载安装脚本后本地执行。Qhermes命令找不到确认是否执行了source ~/.bashrc或者尝试重新打开终端。如果还是找不到检查~/.local/bin是否在PATH环境变量中。QGateway 启动后无法连接飞书检查飞书应用的事件订阅地址是否配置正确确保服务器的端口默认 8642可以从外网访问。如果在本地测试可以使用 ngrok 等内网穿透工具。9. 总结至此你已经完成了 Hermes Agent 在 Ubuntu 上的完整部署流程。总结一下关键步骤更新系统 → 2. 一键安装 → 3. 初始化配置 → 4. 启动 Gateway → 5. 连接平台整个过程大概 10-15 分钟就能搞定。部署完成后你可以探索 Hermes Agent 的更多功能比如定时任务、技能扩展、多平台连接等。祝你玩得开心