← 返回教程列表
🏛️ Hermes Agent 本地安装教程
版本：v0.11.0 (v2026.4.23) · 更新于：2026年4月
💡 什么是 Hermes Agent？
Nous Research 出品的开源 AI Agent 框架。支持 10+ 消息平台（Telegram、Discord、飞书、微信等）、MCP Servers、Skills、Cron 任务、长期记忆。完全自托管，数据在你自己的设备上。
📋 系统要求
| 操作系统 | 支持版本 | 备注 |
|---|---|---|
| macOS | macOS 12+ | Intel 和 Apple Silicon 均支持 |
| Linux | Ubuntu 20.04+, Debian 11+ | 推荐 Linux 用于生产部署 |
注意：Hermes Agent 当前不提供 Windows 原生支持。Windows 用户可通过 WSL2 运行。
🍎 macOS 安装
1
安装 Node.js
Hermes Agent 需要 Node.js 20+ 和 npm：
# 使用 Homebrew brew install node@20 # 或直接从官网下载 # https://nodejs.org/
2
克隆项目
git clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent
3
安装依赖
npm install
安装过程可能需要几分钟。
4
配置环境
复制配置文件并编辑：
cp config.example.yaml config.yaml
编辑 config.yaml 文件，至少配置：
- LLM Provider：设置你的 AI 模型（如 OpenAI、Anthropic、DeepSeek）
- 平台连接：启用你需要的消息平台（如 Terminal、Telegram、飞书等）
5
启动 Hermes Agent
npm start
终端模式下直接输入消息即可对话。
🐧 Linux 安装
1
安装 Node.js 20
# Ubuntu/Debian curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs # 验证安装 node --version # 应显示 v20.x
2
克隆并安装
git clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent npm install
3
配置
cp config.example.yaml config.yaml # 用 vim/nano 编辑 config.yaml 配置 Provider 和平台
4
启动
npm start
🪟 Windows（WSL2 方式）
1
安装 WSL2
以管理员身份打开 PowerShell，运行：
wsl --install -d Ubuntu
重启电脑后，完成 Ubuntu 初始化设置。
2
在 Ubuntu 中安装 Hermes
按照上方 Linux 安装步骤操作即可。
🛠️ 常用命令
| 命令 | 说明 |
|---|---|
npm start | 启动 Hermes Agent |
npm run dev | 开发模式启动（热重载） |
npm test | 运行测试 |
npm run build | 构建生产版本 |
🔧 常见问题
启动时报错 "Cannot find module"
运行 npm install 重新安装依赖。
如何切换平台？
编辑 config.yaml 中的 platforms 段，注释掉不需要的平台。
如何更新？
git pull origin main npm install
📖 下一步
xia007 · 养虾人的导航站