你是否遇到過這些問題——AI 智能體裝了一堆，但每次對(duì)話都"失憶"？換了模型就得重新配置？想接入飛書/釘釘卻無從下手？Hermes Agent 正是為解決這些痛點(diǎn)而生。它是一款開源自進(jìn)化 AI 智能體，支持持久記憶、技能自動(dòng)沉淀、200 + 模型一鍵切換，可接入飛書 / 釘釘?shù)?15 + 平臺(tái)。本文從環(huán)境準(zhǔn)備、多平臺(tái)安裝、配置驗(yàn)證到更新卸載，提供全流程實(shí)操指南，適配國內(nèi)網(wǎng)絡(luò)環(huán)境，兼顧新手與進(jìn)階用戶。

一、核心優(yōu)勢與同類工具對(duì)比

安裝前先明確 Hermes Agent 定位，區(qū)別于主流 AI 工具：

1. Hermes Agent 核心特點(diǎn)

• 自進(jìn)化閉環(huán)：基于 GEPA 引擎，自動(dòng)提煉技能、優(yōu)化能力
• 全模型兼容：支持國產(chǎn)（智譜、Kimi）+ 海外（OpenAI、Cla）+ 本地（Ollama）模型
• 多平臺(tái)網(wǎng)關(guān)：一鍵接入飛書、釘釘、企業(yè)微信
• 安全沙箱：支持 Docker/SSH 隔離執(zhí)行，保障安全

2. 與同類工具關(guān)鍵對(duì)比

選型建議：

• 選 Hermes Agent：需全場景、長期記憶、不鎖定模型
• 選 Claude Code：專注復(fù)雜代碼開發(fā)
• 選 OpenClaw：優(yōu)先多平臺(tái)接入、無需自進(jìn)化

二、系統(tǒng)與環(huán)境準(zhǔn)備

1. 支持系統(tǒng)

• ? 完全支持：macOS、Linux（Ubuntu/Debian/Fedora）、Windows WSL2（推薦）
• ?? Beta 支持：Windows 原生 PowerShell（兼容性一般）
• ? 不支持：Windows 原生 CMD、32 位系統(tǒng)

2. 基礎(chǔ)依賴（僅需手動(dòng)裝 Git）

• Git（必需，2.0+ 版本）
• 自動(dòng)安裝：Python 3.11、Node.js v22、uv、ripgrep、ffmpeg

3. 國內(nèi)網(wǎng)絡(luò)提示

安裝腳本默認(rèn)走國內(nèi)鏡像加速，優(yōu)先直連國內(nèi)鏈路，精簡外網(wǎng)依賴。

4. 依賴檢查

git --version  # 輸出版本即正常

圖1：Hermes Agent 多平臺(tái)安裝流程

掌握了系統(tǒng)環(huán)境和依賴檢查，接下來進(jìn)入核心環(huán)節(jié)——根據(jù)你的操作系統(tǒng)選擇對(duì)應(yīng)的一鍵安裝方式。

三、多平臺(tái)一鍵安裝（國內(nèi)鏡像，推薦）

1. macOS / Linux / WSL2（最穩(wěn)）

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

安裝完成后刷新環(huán)境：

source ~/.bashrc  # bash 用戶

2. Windows 原生 PowerShell（Beta）

以普通身份打開 PowerShell，執(zhí)行：

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

安裝后關(guān)閉并重啟 PowerShell 生效。

3. Android / Termux

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

自動(dòng)適配 Termux 環(huán)境，精簡桌面依賴。

4. 驗(yàn)證安裝

hermes --version  # 輸出版本（v0.14+）成功
hermes doctor     # 自動(dòng)檢測依賴/配置問題

安裝驗(yàn)證通過后，還需要配置大模型才能開始對(duì)話。以下是安裝后必須完成的基礎(chǔ)配置。

四、安裝后基礎(chǔ)配置

1. 配置大模型（必做）

hermes model  # 交互式選擇模型提供商

國內(nèi)模型（無海外網(wǎng)絡(luò)）

• 智譜 GLM：設(shè)置 ZHIPUAI_API_KEY
• Kimi：設(shè)置 KIMI_API_KEY
• 阿里云通義千問：設(shè)置 DASHSCOPE_API_KEY

本地模型（Ollama）

• 安裝 Ollama 并啟動(dòng)模型（如 Llama3）
• 選擇「Custom Endpoint」，輸入 http://localhost:11434/v1

2. 配置文件說明

所有配置在 ~/.hermes/ 目錄：

• config.yaml：主配置（工具 / 網(wǎng)關(guān)）
• .env：存儲(chǔ) API Key（權(quán)限設(shè) 600）
• memories/：持久記憶文件
• skills/：自動(dòng) / 手動(dòng)技能

3. 首次啟動(dòng)對(duì)話

hermes                    # 進(jìn)入交互式會(huì)話
? 你好，幫我總結(jié) Hermes 功能

以上是標(biāo)準(zhǔn)安裝流程，滿足多數(shù)場景。如果你需要從源碼構(gòu)建或生產(chǎn)環(huán)境部署，可以參考以下進(jìn)階安裝方式。

五、進(jìn)階安裝（手動(dòng) / Docker）

1. 手動(dòng)安裝（開發(fā)者）

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

uv venv --python 3.11
source .venv/bin/activate  # Linux/macOS

uv pip install -e ".[all]"

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. Docker 部署（生產(chǎn)環(huán)境）

docker pull nousresearch/hermes-agent:latest

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -e OPENROUTER_API_KEY=你的密鑰 \
  nousresearch/hermes-agent gateway run

六、更新與卸載

1. 一鍵更新

hermes update  # 拉取最新代碼、更新依賴、重啟網(wǎng)關(guān)

2. 卸載

hermes uninstall  # 可選擇保留配置文件

3. 手動(dòng)清理

rm -rf ~/.local/bin/hermes
rm -rf ~/.hermes
rm -rf 安裝目錄/hermes-agent

七、常見問題排查

問題1：hermes: command not found

執(zhí)行 source ~/.bashrc，或檢查 ~/.local/bin 是否加入 PATH。

問題2：依賴下載失?。▏鴥?nèi)）

切換網(wǎng)絡(luò)，關(guān)閉代理 / VPN，或用清華鏡像：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn

問題3：Windows PowerShell 編碼錯(cuò)誤

管理員身份執(zhí)行：

reg add "HKLM\SYSTEM\CurrentControlSet\Control\Nls\CodePage" /v ACP /t REG_SZ /d 65001 /f

問題4：WSL2 網(wǎng)絡(luò)問題（本地模型連不上）

用 WSL2 的 Windows 主機(jī) IP 連接（如 http://192.168.1.100:11434）。

八、總結(jié)

Hermes Agent 安裝核心是國內(nèi)鏡像 + 環(huán)境適配，新手優(yōu)先用 WSL2 + 一鍵腳本，省心穩(wěn)定。安裝后配置國產(chǎn)模型即可直接使用，無需海外網(wǎng)絡(luò)。后續(xù)可進(jìn)階配置消息網(wǎng)關(guān)、自定義技能、接入 MCP 工具，打造專屬 AI 助手。

以上就是5分鐘帶你搞定Hermes Agent:支持200+模型一鍵切換和飛書釘釘接入(附全流程實(shí)操)的詳細(xì)內(nèi)容，更多關(guān)于Hermes Agent實(shí)戰(zhàn)教程的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論