前言

在 AI 技術(shù)快速發(fā)展的今天，將大模型能力接入企業(yè)辦公系統(tǒng)已經(jīng)成為一種趨勢(shì)。無(wú)論是智能問(wèn)答、自動(dòng)化辦公，還是企業(yè)知識(shí)庫(kù)，AI 助手都能極大提升效率。而如何快速、穩(wěn)定地部署一個(gè)可用的 AI 系統(tǒng)，是許多開發(fā)者面臨的第一道門檻。

本文將圍繞開源項(xiàng)目 Hermes Agent，手把手帶你完成從部署到接入飛書機(jī)器人的完整流程。相比零散教程，本文不僅提供詳細(xì)步驟，還會(huì)補(bǔ)充關(guān)鍵原理說(shuō)明與實(shí)踐建議，幫助你真正掌握這套方案。

1 項(xiàng)目概述

1.1 項(xiàng)目確認(rèn)

在開始之前，我們先確認(rèn)所使用的項(xiàng)目信息：

• 倉(cāng)庫(kù)：NousResearch/hermes-agent
• GitHub：https://github.com/NousResearch/hermes-agent
• Docker 鏡像：nousresearch/hermes-agent

該項(xiàng)目提供了完整的 Agent 框架，并內(nèi)置 Gateway，可用于對(duì)接飛書等平臺(tái)。

1.2 Hermes Agent 能做什么

Hermes Agent 本質(zhì)上是一個(gè) AI 調(diào)度系統(tǒng)，它具備以下能力：

• 接入多種大模型（OpenAI、Ollama、Anthropic 等）
• 支持對(duì)話記憶與上下文管理
• 提供 Web UI 與 CLI
• 支持平臺(tái)接入（飛書、Slack 等）

你可以把它理解為：

2 環(huán)境準(zhǔn)備

2.1 Docker 安裝驗(yàn)證

首先確保你已經(jīng)安裝 Docker：

docker --version

如果能正常輸出版本號(hào)，說(shuō)明安裝成功。

2.2 環(huán)境建議

為了保證運(yùn)行穩(wěn)定，建議環(huán)境如下：

如果你使用本地模型（如 Ollama），則需要更高配置。

3 使用官方鏡像部署 Hermes

3.1 拉取鏡像

docker pull nousresearch/hermes-agent:latest

這是官方提供的鏡像，包含完整運(yùn)行環(huán)境。

3.2 創(chuàng)建數(shù)據(jù)目錄

mkdir -p ~/.hermes

該目錄用于存儲(chǔ)：

• 配置文件
• 對(duì)話記憶
• 日志數(shù)據(jù)

這一步非常重要，否則數(shù)據(jù)不會(huì)持久化。

3.3 初始化配置

docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent \
  setup

執(zhí)行后會(huì)進(jìn)入交互式配置流程。

你需要填寫：

• LLM 提供商（如 OpenAI）
• API Key
• 模型名稱

例如：

3.4 啟動(dòng) Web 服務(wù)

docker run -d \
  --name hermes \
  --restart always \
  -p 8000:8000 \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent \
  hermes gateway run

訪問(wèn)地址：http://localhost:8000

你可以通過(guò)瀏覽器直接使用 Hermes。

3.5 CLI 模式體驗(yàn)

docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent

CLI 模式適合調(diào)試或快速測(cè)試。

4 飛書機(jī)器人創(chuàng)建流程

4.1 進(jìn)入開發(fā)者平臺(tái)

打開飛書開放平臺(tái)：https://open.feishu.cn/

登錄后進(jìn)入開發(fā)者后臺(tái)。

4.2 創(chuàng)建企業(yè)自建應(yīng)用

填寫基本信息：

• 應(yīng)用名稱：Hermes AI
• 應(yīng)用描述：AI 助手

創(chuàng)建后進(jìn)入應(yīng)用詳情頁(yè)。

4.3 獲取關(guān)鍵憑證

在“憑證與基礎(chǔ)信息”中獲?。?/p>

• App ID
• App Secret

注意：Secret 只會(huì)顯示一次，務(wù)必保存。

4.4 添加機(jī)器人能力

左側(cè)菜單：添加能力 → 機(jī)器人 → 添加

進(jìn)入 機(jī)器人 設(shè)置：

• 開啟 啟用機(jī)器人
• 消息模式：私聊 + 群聊
• 權(quán)限：全部權(quán)限（或按需）

4.5 發(fā)布應(yīng)用

左側(cè)：版本管理與發(fā)布 → 創(chuàng)建版本

填寫版本信息（隨便填）→ 保存

點(diǎn)擊 發(fā)布

企業(yè)內(nèi)應(yīng)用：無(wú)需審核，立即生效

5 Hermes 接入飛書

5.1 使用向?qū)渲?/h3>

docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway setup

按照提示填寫：

• 平臺(tái)列表：選擇 feishu（國(guó)內(nèi)飛書）
• App ID：粘貼你剛才的 cli_xxxxxx
• App Secret：粘貼你的密鑰
• Domain：直接回車（默認(rèn) feishu）
• Connection mode：直接回車（默認(rèn) websocket，最穩(wěn)定）
• Allowed User IDs：留空 → 下一步
• Authentication：輸入 1（允許所有人使用）
• 最后選 Done 保存

5.2 手動(dòng)配置方式

如果你不喜歡交互方式，也可以手動(dòng)配置：

docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent \
  config set feishu_app_id cli_xxxxxx

依次設(shè)置：

• feishu_app_id
• feishu_app_secret
• feishu_domain
• feishu_connection_mode

這種方式適合自動(dòng)化部署。

6 啟動(dòng)飛書網(wǎng)關(guān)

6.1 清理舊容器

docker rm -f hermes

避免端口沖突。

6.2 啟動(dòng)服務(wù)

docker run -d \
  --name hermes \
  --restart always \
  -p 8000:8000 \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent \
  gateway run

6.3 日志檢查

docker logs -f hermes

當(dāng)看到如下日志時(shí)：

[Gateway] feishu gateway connected

說(shuō)明連接成功。

7 實(shí)際使用方法

7.1 私聊機(jī)器人

在飛書中：

通訊錄 → 機(jī)器人 → Hermes AI

發(fā)送消息即可開始對(duì)話。

7.2 群聊使用

操作流程：

創(chuàng)建群聊

添加機(jī)器人

發(fā)送消息或 @機(jī)器人

8 常見問(wèn)題

8.1 機(jī)器人不回復(fù)

請(qǐng)依次檢查：

• 應(yīng)用是否已發(fā)布
• App ID / Secret 是否正確
• 容器是否運(yùn)行

8.2 群聊不生效

可能原因：

• 未開啟群聊權(quán)限
• require_mention 設(shè)置為 true

8.3 調(diào)試建議

docker logs -f hermes

重點(diǎn)查看錯(cuò)誤信息。

結(jié)語(yǔ)

通過(guò)本文的講解，你已經(jīng)掌握了從部署 Hermes Agent 到接入飛書機(jī)器人的完整流程。這套方案的核心優(yōu)勢(shì)在于簡(jiǎn)單、高效、可擴(kuò)展，非常適合個(gè)人開發(fā)者和企業(yè)內(nèi)部使用。

如果你希望進(jìn)一步提升系統(tǒng)能力，可以嘗試引入 RAG、工具調(diào)用、甚至多 Agent 協(xié)作，讓你的 AI 助手真正成為生產(chǎn)力工具。

到此這篇關(guān)于基于Docker部署Hermes Agent并接入飛書機(jī)器人的完整指南的文章就介紹到這了,更多相關(guān)Hermes Agent接入飛書內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論