最近在開源 Agent 圈里，Hermes Agent 的名字反復(fù)出現(xiàn)在各種討論中。有人戲稱它為"愛馬仕 Agent"，起初我也以為這又只是一個新出的 AI CLI 工具。但在實際部署體驗一周后，我發(fā)現(xiàn)它與普通 Agent 之間的差異很明顯——它不只是在"完成任務(wù)"，而是在每一次交互中沉淀經(jīng)驗，用一套學(xué)習(xí)閉環(huán)讓自己變得越來越好用。

這篇文章將我從零開始部署 Hermes Agent 并接入飛書的完整過程做一個系統(tǒng)梳理，希望能幫助想入手的同學(xué)降低試錯成本。

一、Hermes Agent 是什么

簡單來說，Hermes Agent 是由 AI 研究機構(gòu) Nous Research 開發(fā)的開源自主 AI 智能體框架，遵循 MIT 開源協(xié)議，這意味著使用上手門檻幾乎為零。它的核心定位是——一個運行在你自己服務(wù)器上、越用越聰明的 AI Agent。

與常見 AI Agent 的關(guān)鍵區(qū)別在于，它內(nèi)置了一套閉環(huán)學(xué)習(xí)機制：

• 記住跨會話上下文：通過 FTS5 全文搜索與 LLM 摘要，能夠搜索數(shù)周前的對話細節(jié)，而不是"聊完就忘"。
• 自主沉淀技能文檔：完成復(fù)雜任務(wù)后，將經(jīng)驗自動提煉為可復(fù)用的結(jié)構(gòu)化 Skill 文件。
• 持續(xù)自我改進：技能在使用中會持續(xù)優(yōu)化，越用越好用。

這套體系意味著，Hermes 不僅執(zhí)行任務(wù)，還能在實踐中不斷反思、學(xué)習(xí)、進化，而無需用戶手動來微調(diào)或編寫提示詞。

Hermes 支持 400+ 模型調(diào)用（包括 OpenAI、Claude、Ollama 本地模型、Kimi 等），并通過 Telegram、Discord、飛書等多個消息平臺與用戶交互，可 7×24 小時在服務(wù)器上自主運行。

二、安裝前的環(huán)境準(zhǔn)備

在動安裝前，先確認(rèn)環(huán)境滿足要求：

• 操作系統(tǒng)：Linux（主流發(fā)行版）、macOS、Windows WSL2、Android Termux 均可。
• Python：3.10+（不用手動裝，安裝腳本會自動處理）。
• Git：需要手動裝一下。
• 內(nèi)存：建議 4GB+，如果打算本地跑 7B+ 模型的話建議 16GB+。
• 網(wǎng)絡(luò)：需要能夠正常訪問 GitHub（因為安裝腳本需要從倉庫下載）。

Windows 不支持原生環(huán)境，一定要先啟用 WSL2（管理員 PowerShell 中執(zhí)行 wsl --install）。

三、一行命令完成安裝

環(huán)境就緒后就可以開始安裝了。Hermes 的安裝方式是目前見過的開源 Agent 里最簡單的那檔——一條命令行搞定。

打開終端（Windows 用戶在 WSL2 的 Ubuntu 終端中），執(zhí)行：

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

這條命令會自動檢測并安裝所有必需依賴：uv（Python 包管理）、Python 3.10+、Node.js、ripgrep、ffmpeg 等，無需逐一手動安裝。

腳本跑完后，如果看到 “Starting setup wizard”，那恭喜你，安裝成功。

四、按照向?qū)瓿沙跏寂渲?/h2>

安裝成功后會自動進入交互式初始配置向?qū)?。這個過程決定了 Hermes 的"大腦"用哪個模型，以及一會兒要在哪些平臺上用。

4.1 選擇配置模式

向?qū)o出兩個選擇：

• Quick setup：適合新手，按流程一步步配就完事。
• Advanced setup：適合有經(jīng)驗的老手，想細化配置的用這個。

新手同學(xué)直接選 Quick setup 就行。

4.2 配置模型供應(yīng)商

這里你根據(jù)自己的情況來選：

• 有 OpenAI / Anthropic / Kimi 等 API Key：在 provider 列表里直接選對應(yīng)服務(wù)商，然后填入 API Key 和 Model Name。
• 要用 Ollama 跑本地模型：選 Ollama provider，確認(rèn)本地服務(wù)地址（通常是 http://localhost:11434）。
• 使用自定義 API 端點（比如火山方舟、阿里云百煉）：選 “Custom endpoint (enter URL manually)”，然后手動填 API Base URL 和 Key。

4.3 消息平臺選擇（建議先跳過）

在向?qū)У南⑵脚_列表中，可能沒有飛書選項，這屬于正常。建議在這個環(huán)節(jié)直接選擇 Skip，飛書的接入我們后面通過 hermes gateway setup 單獨來做。

4.4 驗證安裝

配置完成后，在終端輸入：

hermes

進入交互式 CLI 界面，隨便輸入一句，如果能正常收到響應(yīng)，就說明安裝和模型配置已經(jīng) OK 了。

五、飛書接入完整流程

安裝配置沒問題之后，接下來就是飛書對接。

整個飛書接入分為兩大步：飛書開放平臺側(cè)配置（獲取 App ID、App Secret、配置回調(diào)）和 Hermes 側(cè)配置（Gateway 設(shè)置）。

5.1 飛書開放平臺側(cè)配置

第一步：創(chuàng)建企業(yè)自建應(yīng)用

登錄 飛書開放平臺，進入開發(fā)者后臺，點擊 「創(chuàng)建企業(yè)自建應(yīng)用」，輸入應(yīng)用名稱和應(yīng)用描述后點創(chuàng)建。應(yīng)用名稱會對應(yīng)之后用戶在飛書上搜到的機器人名，建議取一個好記的。

第二步：添加機器人能力

在應(yīng)用詳情頁左側(cè)，找到 「添加應(yīng)用能力」，然后勾選 「機器人」 能力添加。

第三步：配置必要權(quán)限

左側(cè)導(dǎo)航欄進入 「權(quán)限管理」，至少需要添加：

• im:message — 獲取與發(fā)送消息的核心權(quán)限
• im:resource — 獲取消息中的資源文件

如果想讓機器人在群聊中也穩(wěn)定工作，建議再補上 im:chat:readonly 和 admin:app.info:readonly。

第四步：獲取 App ID 和 App Secret

左側(cè)導(dǎo)航欄進入 「憑證與基礎(chǔ)信息」，找到 App ID 和 App Secret，這兩樣先存好，一會兒 Hermes 側(cè)配置就靠它了。

第五步：配置事件訂閱

左側(cè)導(dǎo)航欄進入 「事件與回調(diào)」，在訂閱方式里選擇 「長連接」，然后添加事件 im.message.receive_v1。這樣每當(dāng)有用戶在飛書里給機器人發(fā)消息時，Hermes 就能第一時間收到回調(diào)事件。

第六步：發(fā)布應(yīng)用

完成以上配置后，在左側(cè)導(dǎo)航欄進入 「版本管理與發(fā)布」，創(chuàng)建新版本并提交發(fā)布。審核通過后，飛書內(nèi)就能搜到并開始用了。

5.2 Hermes 側(cè)配置

飛書側(cè)的準(zhǔn)備工作都搞完了，現(xiàn)在回到 Hermes 的終端環(huán)境：

第一步：啟動 Gateway 配置向?qū)?/strong>

hermes gateway setup

hermes gateway start