Hermes Agent 上手指南:安装、配置模型、接入消息网关

想部署一个真正能做事、跨会话记得住上下文的 AI 智能体，而不是又一个聊天机器人？本文给出可直接落地的方案：Nous Research 开源的 Hermes Agent。

官方定义只有一句话：

"The agent that grows with you." —— 一个会随使用不断成长的 Agent。

它不止是聊天工具——能执行终端命令、操控浏览器、读写文件、联网搜索、生成图像，并且跨会话保持记忆。本文按「安装 → 配置模型 → 接入消息网关」三步带你从 0 到 1 部署，全程可复现。

一、为什么是 Hermes Agent

先看它和普通 AI 聊天的本质差异：

核心能力可以概括为五件事：

• • 连接（Connect）：一个 Agent、统一记忆，多平台无缝续聊。Telegram 发起的对话，在终端能继续。
• • 记忆（Remember）：自动学习你的项目、生成技能，会话结束后重要信息写入持久记忆。
• • 定时（Schedule）：用自然语言设定定时任务——日报、备份、晨间简报，后台无人值守运行。
• • 委派（Delegate）：生成带独立上下文、独立终端和 RPC 脚本的隔离子 Agent，实现并行流水线。
• • 搜索与多模态（Search）：网页搜索、浏览器自动化、视觉理解、图像生成、文字转语音，全部内置。

二、整体架构

Hermes 采用分层架构，核心数据流如下：

各层职责：

三、快速安装

⚠️ 安装命令适用于 Linux、macOS 与 WSL2。Windows 原生不支持，请先装 WSL2。

一键安装：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后重载 Shell 配置：

source ~/.bashrc   # bash# 或source ~/.zshrc    # zsh

验证安装：

hermes --version

输出版本号即安装成功。安装脚本会自动处理全部依赖：

• • uv —— 快速 Python 包管理器
• • Python 3.11 —— 通过 uv 安装，无需 sudo
• • Node.js v22 —— 浏览器自动化与 WhatsApp 桥接
• • ripgrep —— 快速文件搜索
• • ffmpeg —— TTS 音频格式转换

桌面版用户可前往 hermes-agent.nousresearch.com 下载对应平台的安装包，CLI 与桌面应用会同时安装。

四、配置模型提供商

Hermes 支持自由切换任意大模型，无厂商锁定。首次使用必须配置至少一个 LLM 提供商：

hermes model   # 交互式选择提供商与模型

常用提供商与设置方式：

五、常用命令速查

六、接入消息网关：一个网关，15+ 平台

消息网关让你通过多个平台与智能体交互。一条网关配置，即可同时接入 Telegram、Discord、Slack、WhatsApp、Signal、钉钉、飞书、企业微信、Home Assistant 等 15+ 平台。

交互式配置（推荐）：

hermes gateway setup

或手动编辑 ~/.hermes/config.yaml。以 Telegram 为例：

# ~/.hermes/.env 中填入 bot tokenTELEGRAM_BOT_TOKEN=your-bot-token

# config.yamlgateway:  adapters:    telegram:      enabled: true

启动网关：

hermes gateway          # 前台运行hermes gateway &        # 后台运行（推荐）

生产环境建议用 systemd 托管：systemctl enable hermes-agent && systemctl start hermes-agent。

七、安全注意事项

⚠️ 给智能体开放终端执行和浏览器权限后，务必做好以下安全措施：

• • 不要把 API 密钥提交到源码仓库，用环境变量或安全凭据存储
• • 限制允许与智能体交互的用户 / 频道
• • 定期轮换 API 密钥
• • 在公共平台上启用命令审批

八、常见问题排查

不确定问题出在哪，先跑 hermes doctor，它会告诉你缺什么、怎么修。

小结

部署 Hermes Agent 只需三步：一键安装 → 配置模型 → 接入消息网关。相比普通聊天 AI，它最大的价值是"越用越懂你"——持久记忆 + 多平台触达 + 300+ 模型自由切换。建议从 hermes --tui 的交互界面开始，再逐步开启定时任务和子 Agent 委派。

进阶资源：

• • GitHub 仓库：https://github.com/NousResearch/hermes-agent
• • 官方文档（含中文）：https://hermes-agent.nousresearch.com
• • 技能标准：https://agentskills.io