Skip to main content
Installation

Hermes Agent 安装教程

这个页面面向搜索「Hermes Agent 中文安装」「Hermes Agent Windows 安装」「Hermes Agent 自托管部署」的用户， 先给你一条最短路径：Windows 用户先决定走 WSL2 还是 PowerShell，装好 Hermes 后再配置模型、消息网关和 MCP。

Unix / WSL2

类 Unix / WSL2 一键安装命令

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

Linux、macOS 和 WSL2 都走这条镜像命令。它会优先使用国内可直连下载链路；对大多数 Windows 用户来说，WSL2 仍然是最稳、最省心的长期方案。

查看完整安装文档 ↗
Windows

原生 Windows PowerShell 命令

irm https://res1.hermesagent.org.cn/install.ps1 | iex

如果你不想先配置 WSL2，可以直接在 PowerShell 中运行镜像版 Windows 安装器； 但如果你准备长期使用终端工具、网关和自动化，仍建议优先回到 WSL2。

查看 Windows 安装指南 ↗
Environments

支持哪些部署环境

  • Linux / macOS：最贴近官方文档，适合作为长期使用环境。
  • WSL2：适合大多数 Windows 用户，推荐优先选择。
  • Windows PowerShell：可直接安装，但更适合快速体验或轻量使用。
  • Docker / VPS：适合需要长期在线、接入消息平台和自动化任务的场景。
  • Termux：适合 Android 手机端实验和移动设备场景。
Windows 指南Docker 指南Termux 指南
Mainland China

中国大陆网络环境提示

当前页面提供的安装命令已经由 Hermes Agent 中文社区 接入 国内镜像加速，默认优先使用国内可直连的下载链路。

如果 Cloudflare 的节点在你这里抖动、R2 源码包拉不下来，安装脚本会自动 fallback 到 CNB.cool 的 Git 镜像继续安装；两条路都卡住时再退回 GitHub 上游，无需你手动切换。

为了提高中国大陆用户的安装体验，镜像版安装器默认精简了部分国人不常用、或体积较大且经常受外网影响的可选功能， 例如浏览器自动化、Chromium 下载、WhatsApp 桥接等。建议先完成核心安装，确认 `hermes` 可以正常运行； 在完成 Hermes 安装后，可让 Hermes Agent 自身补全这些能力。

如果你还需要处理 WSL 网络、终端代理或手动镜像配置，可参考：

Path

推荐上手顺序

  1. 先完成安装，并确认 `hermes` 命令能正常运行。
  2. 配置模型供应商，如 Qwen、GLM、Kimi、Claude 或 OpenAI 兼容接口。
  3. 进入快速开始，验证对话、工具和会话历史都工作正常。
  4. 按需继续接入消息网关、长期记忆与 MCP Server。
快速开始模型配置
After Install

装好之后最值得做的三件事

  • 把常用模型和 API Key 配好，确保 Hermes 先能稳定回答问题。
  • 打开长期记忆和 Skills，让它在真实任务里越用越懂你。
  • 接入微信、飞书、电报等消息平台，让 Agent 可以脱离终端继续工作。
长期记忆消息网关
FAQ

Hermes Agent 支持哪些安装环境？

Hermes Agent 适合运行在 Windows（WSL2 / PowerShell）、Linux、macOS、Docker、VPS 和 Termux 环境中。中文用户通常可以先从本机或一台轻量 VPS 开始，后续再接入消息网关与自动化任务。

FAQ

Windows 怎么安装最省心？

Windows 用户有两条路线：想要最稳的体验就用 WSL2，在 Ubuntu 里运行中文社区维护的镜像版 install.sh；想在 PowerShell 中快速跑起来，也可以直接使用镜像版 install.ps1。镜像安装器默认先保证核心链路可用，长期使用时仍优先推荐 WSL2。

FAQ

安装后应该先做什么？

建议按“安装 → 配置模型 → 启动 Hermes → 接入消息网关”的顺序进行。这样可以先确认核心对话能力，再逐步扩展到 MCP、长期记忆和多平台通知。