Hermes Agent 安裝教程

類 Unix / WSL2 一鍵安裝命令

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

Linux、macOS 和 WSL2 都走這條鏡像命令。它會優先使用國內可直連下載鏈路；對大多數 Windows 用戶來說，WSL2 仍然是最穩、最省心的長期方案。

原生 Windows PowerShell 命令

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

如果你不想先配置 WSL2，可以直接在 PowerShell 中運行鏡像版 Windows 安裝器； 但如果你準備長期使用終端工具、網關和自動化，仍建議優先回到 WSL2。

支持哪些部署環境

• Linux / macOS：最貼近官方文檔，適合作為長期使用環境。
• WSL2：適合大多數 Windows 用戶，推薦優先選擇。
• Windows PowerShell：可直接安裝，但更適合快速體驗或輕量使用。
• 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，讓它在真實任務裡越用越懂你。
• 接入微信、飛書、電報等消息平臺，讓 Agent 可以脫離終端繼續工作。

Hermes Agent 支持哪些安裝環境？

Hermes Agent 適合運行在 Windows（WSL2 / PowerShell）、Linux、macOS、Docker、VPS 和 Termux 環境中。中文用戶通常可以先從本機或一臺輕量 VPS 開始，後續再接入消息網關與自動化任務。

Windows 怎麼安裝最省心？

Windows 用戶有兩條路線：想要最穩的體驗就用 WSL2，在 Ubuntu 裡運行中文社區維護的鏡像版 install.sh；想在 PowerShell 中快速跑起來，也可以直接使用鏡像版 install.ps1。鏡像安裝器默認先保證核心鏈路可用，長期使用時仍優先推薦 WSL2。

安裝後應該先做什麼？

建議按“安裝 → 配置模型 → 啟動 Hermes → 接入消息網關”的順序進行。這樣可以先確認核心對話能力，再逐步擴展到 MCP、長期記憶和多平臺通知。