Hermes Agent 安装与 Quickstart：第一次跑通完整清单

Hermes 安装 新手 入门 预计 12 分钟 发布于 2026/5/23 核验于 2026/6/1

第一次安装 Hermes，不要一上来就追求把 messaging gateway、cron、skills 全部打开。最稳的路线是先让 CLI 跑起来，再确认模型、工具和基础配置，最后再进入消息入口或迁移。

先抓住 3 个关键点

1. 官方 README 给出了 Linux、macOS、WSL2、Termux 和 Windows PowerShell 的安装路径。
2. Windows 原生支持处于早期阶段，遇到终端、PTY 或 dashboard 相关问题时，WSL2 往往更稳。
3. 安装成功不等于可长期使用，模型、工具、gateway、memory 都要逐步验收。

最小安装路径

Linux、macOS、WSL2 和 Termux 的官方一行命令是：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后，先重新加载 shell，再启动 Hermes：

source ~/.zshrc
hermes

如果你使用 bash，可以把第一条换成：

source ~/.bashrc

Windows PowerShell 路径需要单独看官方 README，因为官方明确提示原生 Windows 还在早期 beta。生产或长期使用前，不要把一次安装成功理解成所有能力都已经充分稳定。

首次启动后先做什么

建议按这个顺序：

1. hermes：确认交互 CLI 能启动。
2. hermes model：选择模型提供方和模型。
3. hermes tools：检查哪些工具启用。
4. hermes setup：如果你想走向导式配置，使用 setup 统一处理。
5. hermes gateway：只有当 CLI 和模型都稳定后，再启动消息网关。

首次验收清单

常见坑

• API Key 没准备好，就开始调试 gateway。
  先让模型问答成功，再接消息入口。

• 看到 gateway 支持多个平台，就一次性全接。
  先选一个低风险入口测试，比如个人 Telegram 测试会话，再扩展。

• 从 OpenClaw 直接迁移但不 dry-run。
  迁移前应先看迁移预览和 secrets 策略，不要把迁移当成普通升级。

下一步

如果你来自 OpenClaw，下一步看迁移页；如果你是全新用户，建议先看 Memory 教程，理解 Hermes 的长期价值来自哪里。