养马日记：“马厩”搭建指南：Hermes Agent 极简部署与多平台接入实操
【Phase 2：从 0 到 1 的“驯马”实战 —— 第3篇】
在第一、第二篇《养马日记》中，我们分别从宏观愿景和底层机制的角度，领略了 Nous Research 出品的 Hermes Agent 这只“数字化神驹”的魅力。但俗话说得好，“光说不练假把式”，再牛的架构，跑不起来都是瞎扯。
今天，我们就来撸起袖子，挽起袖子，动手为咱们的 Hermes 搭一个安稳的“马厩”。本篇博客将提供保姆级的安装教程，涵盖本地裸机部署、Docker 容器化部署，以及云端一键部署。更重要的是，我会手把手教你如何将它接入微信、Telegram 或 Slack 等常用 IM 工具，让它真正融入你的日常工作和生活。
一、 本地“马厩”搭建：一键脚本与手动编译
Hermes Agent 的本地部署非常简单，官方提供了一键安装脚本。但在开搞之前，咱们得先明确一下“硬件门槛”和“地皮要求”：
- 操作系统：Linux、macOS、WSL2（Windows 用户强烈建议先装 WSL2）。
- 脑容量（内存）：至少 1GB（如果开启浏览器自动化工具，建议 2GB 以上）。
- 模型要求：由于 Hermes 主打长上下文和复杂任务，你需要配置一个支持至少 64,000 tokens 上下文窗口的模型（比如
claude-3.5-sonnet或gpt-4o）。
1. 懒人福音：一键安装脚本
打开你的终端（Windows 用户请打开 WSL2 终端或 PowerShell），复制粘贴以下命令并回车：
# Linux / macOS / WSL2curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash# Windows (原生 PowerShell 管理员模式)irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1|iex这个神奇的脚本会自动帮你检测系统架构，安装uv（超快的 Python 包管理器）、Python 3.11、Node.js v22，克隆仓库并创建虚拟环境。
⚠️ 新手避坑指南 1：Shell 刷新
安装完成后，千万不要急着敲命令！你必须重新加载一下 Shell 配置，否则系统会找不到hermes命令：
# bash 用户source~/.bashrc# zsh 用户 (macOS 默认)source~/.zshrc随后，输入hermes --version，如果输出了版本号，恭喜你，马鞍已经备好！
2. 极客玩法：Docker 容器化部署
如果你不想污染本地的开发环境，或者想把 Hermes 扔到云服务器上 24 小时不间断跑着，Docker 绝对是你的不二之选。
第一步：准备数据目录与配置文件
Docker 部署的核心在于持久化存储。所有的技能、记忆和配置都会存在这里，哪怕你删了容器，数据依然安好：
mkdir-p~/.hermes第二步：交互式初始化（推荐新手）
运行以下命令，容器会引导你完成 API Key 和模型的配置：
dockerrun-it--rm\-v~/.hermes:/opt/data\nousresearch/hermes-agent:latest setup跟着提示一路 Next，配置好你的模型提供商（如 OpenRouter、DeepSeek 等）和 API Key。
第三步：启动网关（后台守护模式）
配置完成后，就可以让 Hermes 在后台安安静静地当一匹“云马”了：
dockerrun-d\--namehermes-agent\--restartunless-stopped\-v~/.hermes:/opt/data\-p3000:3000\nousresearch/hermes-agent:latest gateway run💡 进阶玩家可以直接用docker-compose.yml，把常用的环境变量（如TELEGRAM_BOT_TOKEN）写在.env文件里，方便迁移和备份。
二、 广交天下友：接入 IM 平台（以 Telegram 和 Slack 为例）
“马厩”搭好了，接下来就要让这匹马出去社交了。Hermes 的一大杀器就是它的Multi-Platform Messaging Gateway（多平台统一网关）。这意味着，无论是 Telegram、Slack 还是 Discord，背后连接的都是同一个 Agent 大脑，共享同一套记忆和技能。
官方强烈建议的顺序是：先在本地 CLI 跑通，再接入 IM 平台。千万不要一上来就接微信/Telegram，否则一旦出问题，你连它到底是断在网线端还是代码端都很难排查。
1. 接入 Telegram（最快 3 分钟搞定）
Telegram 是 Hermes 支持最丝滑的平台，没有之一。
- Step 1：在 Telegram 搜索
@BotFather，输入/newbot，按提示给你的马起个名字，拿到一串123456789:ABCdef...的 Token。 - Step 2：在终端里运行
hermes gateway setup，选择 Telegram，填入 Token。 - Step 3：为了安全，记得设置白名单，只允许你自己的账号使用。把你的 Telegram 数字 ID（可以找
@userinfobot获取）写入配置文件：# 编辑 ~/.hermes/.env 文件TELEGRAM_BOT_TOKEN=123456789:ABCdef...TELEGRAM_ALLOWED_USERS=你的数字ID - Step 4：在服务器上重启网关服务（或重新跑 Docker 容器），然后去给你的 Bot 发一句
/start。如果它礼貌地回了你，恭喜，跨平台通讯打通！
2. 接入 Slack（坑略多，需细心）
Slack 的接入相对繁琐，主要坑点在权限配置上。
- Step 1：访问
api.slack.com/apps，创建一个 App（建议 From Scratch）。 - Step 2：配置权限（OAuth & Permissions）。除了常规的
chat:write，务必加上channels:history和groups:history。否则你的 Bot 在群组里会像金鱼一样“静默忽略”所有人的发言。 - Step 3：开启 Socket Mode（Hermes 推荐使用 WebSocket 长连接，无需暴露公网端口）。
- Step 4：生成 Bot Token (
xoxb-...) 和 App-Level Token (xapp-...)，填入.env文件：SLACK_BOT_TOKEN=xoxb-...SLACK_APP_TOKEN=xapp-...SLACK_ALLOWED_USERS=你的Slack用户ID - Step 5：将 App 安装到你的 Workspace，并在你想聊天的频道里输入
/invite @YourBotName。
三、 云端“赛马场”：一键部署模板（Hermes Alpha）
如果你既没有闲置的本地电脑，也不想折腾云服务器的各种依赖，官方还提供了一个基于 Modal 的云端无服务器部署方案（被称为 Hermes Alpha）。
你只需要 Fork 官方的 https://github.com/NousResearch/hermes-agent-modal 仓库，配置好自己的 API Key 和 Secrets，就能在云端拥有一个随叫随到、用完即走的 Hermes Agent。不过这种模式更适合轻量级、间歇性的任务，对于需要长期沉淀记忆和复杂状态维护的场景，依然推荐买一台便宜的腾讯云/LightSail 服务器做 Docker 持久化部署。
四、 新手避坑大全（血泪总结）
在帮群里的小伙伴 Debug 时，我发现大家踩的坑往往极其雷同。总结以下三点，能帮你节省至少 3 个小时的抓狂时间：
- “金鱼记忆”复发（数据卷未挂载）：
如果你是用 Docker 部署的，千万记得加上-v ~/.hermes:/opt/data。如果不挂载，你每次重启容器，Hermes 都会变成一个“失忆的傻白甜”。 - Windows 原生环境的诅咒：
再次强调，Hermes 的许多底层工具（如ripgrep、部分浏览器自动化组件）对原生 Windows 支持极差。Windows 用户请老老实实开启 WSL2（微软官方 Linux 子系统），在 Ubuntu 子系统里跑，能避开 99% 的奇葩报错。 - 网络围墙（国内服务器特别注意）：
Hermes 在启动和运行过程中会频繁请求你的模型 API（如 OpenAI、Anthropic）以及更新技能库。如果你的服务器在国内，请务必在.env文件中配置好网络代理（HTTPS_PROXY），否则你会看到满屏幕的Connection Timeout。
五、 结语：万事俱备，只欠东风
至此，我们已经成功把 Hermes Agent 这只潜力无限的“神驹”迎进了咱们的“马厩”，并且帮它办好了 Telegram、Slack 等社交平台的“通行证”。它现在正安静地待在后台，等待着你的第一条指令。
然而，光有一个光秃秃的命令行或者聊天窗口，还不足以释放它真正的生产力。在下一篇《养马日记》中，我们将迎来最激动人心的实战环节——跑通第一个自动化工作流。我会教你如何结合系统的 Cron 定时任务和 Hermes 的 Skill 机制，让它每天定时帮你抓取行业新闻、生成精读摘要并自动发送到你的微信上。
敬请期待：《让它替你打工：5分钟跑通你的第一个 Hermes 自动化工作流》
(如果本篇部署指南帮你顺利养马成功，不忘点赞、收藏并关注系列。有任何部署报错，欢迎在评论区贴出日志，我们一起“悬丝诊脉”！)
