Hermes Agent 安裝教程

類 Unix / WSL2 一鍵安裝命令

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

Linux、macOS 和 WSL2 都走這條鏡像命令。它會優先使用國內可直連下載鏈路；對 Windows 用戶來說，WSL2 現在是偏好 Linux / Ubuntu 終端時的可選方案。

原生 Windows PowerShell 命令

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

現階段 Hermes Agent 已經對 Windows 原生安裝做了很多適配，已經可以直接在 PowerShell 中運行鏡像版 Windows 安裝器； 安裝完成後可繼續配置模型、網關和自動化能力。

支持哪些部署環境

• Linux / macOS：最貼近官方文檔，適合作為長期使用環境。
• Windows PowerShell：已經可以原生安裝，適合大多數希望直接在 Windows 本機使用的用戶。
• WSL2：適合偏好 Linux / Ubuntu 終端，或需要 POSIX 語義的 Windows 用戶。
• Docker / VPS：適合需要長期在線、接入消息平臺和自動化任務的場景。
• Termux：適合 Android 手機端實驗和移動設備場景。

中國大陸網絡環境提示

當前頁面提供的安裝命令已經由 Hermes Agent 中文社區 接入 國內鏡像加速，默認優先使用國內可直連的下載鏈路。

如果 Cloudflare 的節點在你這裡抖動、R2 源碼包拉不下來，安裝腳本會自動 fallback 到 CNB.cool 的 Git 鏡像繼續安裝；兩條路都卡住時再退回 GitHub 上游，無需你手動切換。

為了提高中國大陸用戶的安裝體驗，鏡像版安裝器默認精簡了部分國人不常用、或體積較大且經常受外網影響的可選功能， 例如瀏覽器自動化、Chromium 下載、WhatsApp 橋接等。建議先完成核心安裝，確認 `hermes` 可以正常運行； 在完成 Hermes 安裝後，可讓 Hermes Agent 自身補全這些能力。

如果你還需要處理 WSL 網絡、終端代理或手動鏡像配置，可參考：

• Windows 10/11 安裝 WSL2 指南（中文）
• Microsoft Learn：WSL 網絡 / autoProxy
• 清華 TUNA：Python / pip 鏡像幫助
• 清華 TUNA：Node.js 鏡像幫助 / npmmirror

推薦上手順序

1. 先完成安裝，並確認 `hermes` 命令能正常運行。
2. 配置模型供應商，如 Qwen、GLM、Kimi、Claude 或 OpenAI 兼容接口。
3. 進入快速開始，驗證對話、工具和會話歷史都工作正常。
4. 按需繼續接入消息網關、長期記憶與 MCP Server。

裝好之後最值得做的三件事

• 把常用模型和 API Key 配好，確保 Hermes 先能穩定回答問題。
• 打開長期記憶和 Skills，讓它在真實任務裡越用越懂你。
• 接入微信、飛書、QQ等消息平臺，讓 Agent 可以脫離終端繼續工作。

Hermes Agent 支持哪些安装环境？

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

Windows 怎么安装最省心？

Windows 用户有两条路线：现阶段 Hermes Agent 已经对 Windows 原生安装做了很多适配，已经可以直接在 PowerShell 中运行镜像版 install.ps1 原生安装；如果偏好 Linux / Ubuntu 终端，也可以选择 WSL2 并运行 install.sh。

安装后应该先做什么？

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