基于 Docker 部署 Hermes Agent 并接入飞书机器人的完整指南

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

在 AI 技术快速发展的今天，将大模型能力接入企业办公系统已经成为一种趋势。无论是智能问答、自动化办公，还是企业知识库，AI 助手都能极大提升效率。而如何快速、稳定地部署一个可用的 AI 系统，是许多开发者面临的第一道门槛。

本文将围绕开源项目 Hermes Agent，手把手带你完成从部署到接入飞书机器人的完整流程。相比零散教程，本文不仅提供详细步骤，还会补充关键原理说明与实践建议，帮助你真正掌握这套方案。

1.1 项目确认

在开始之前，我们先确认所使用的项目信息：

仓库：NousResearch/hermes-agent
GitHub：https://github.com/NousResearch/hermes-agent
Docker 镜像：nousresearch/hermes-agent

该项目提供了完整的 Agent 框架，并内置 Gateway，可用于对接飞书等平台。

1.2 Hermes Agent 能做什么

Hermes Agent 本质上是一个 AI 调度系统，它具备以下能力：

接入多种大模型（OpenAI、Ollama、Anthropic 等）
支持对话记忆与上下文管理
提供 Web UI 与 CLI
支持平台接入（飞书、Slack 等）

你可以把它理解为：

模块作用 LLM 提供语言理解与生成能力 Agent 负责逻辑控制与任务调度 Gateway 负责对接外部平台

2.1 Docker 安装验证

首先确保你已经安装 Docker：

docker --version

如果能正常输出版本号，说明安装成功。

2.2 环境建议

为了保证运行稳定，建议环境如下：

项目推荐配置 CPU 2核及以上内存 4GB 以上网络可访问外网系统 Linux / macOS

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

3.1 拉取镜像

 
  
    
     
     docker pull nousresearch/hermes-agent:latest 
    
 这是官方提供的镜像，包含完整运行环境。

3.2 创建数据目录

 
  
    
     
     mkdir -p ~/.hermes 
    
 该目录用于存储：

配置文件
对话记忆
日志数据

这一步非常重要，否则数据不会持久化。

3.3 初始化配置

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

执行后会进入交互式配置流程。

你需要填写：

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

例如：

配置项示例 Provider openai Model gpt-4 API Key sk-xxxx

3.4 启动 Web 服务

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

访问地址：

http://localhost:8000

你可以通过浏览器直接使用 Hermes。

3.5 CLI 模式体验

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

CLI 模式适合调试或快速测试。

4.1 进入开发者平台

打开飞书开放平台：

https://open.feishu.cn/

登录后进入开发者后台。

4.2 创建企业自建应用

填写基本信息：

应用名称：Hermes AI
应用描述：AI 助手

创建后进入应用详情页。

4.3 获取关键凭证

在"凭证与基础信息"中获取：

App ID
App Secret

注意：Secret 只会显示一次，务必保存。

4.4 添加机器人能力

左侧菜单：添加能力 → 机器人 → 添加

进入 机器人 设置：

开启 启用机器人
消息模式：私聊 + 群聊
权限：全部权限（或按需）

4.5 发布应用

左侧：版本管理与发布 → 创建版本

填写版本信息（随便填）→ 保存

点击发布

企业内应用：无需审核，立即生效

5.1 使用向导配置

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

按照提示填写：

平台列表：选择 feishu（国内飞书）
App ID：粘贴你刚才的 cli_xxxxxx
App Secret：粘贴你的密钥
Domain：直接回车（默认 feishu）
Connection mode：直接回车（默认 websocket，最稳定）
Allowed User IDs：留空 → 下一步
Authentication：输入 1（允许所有人使用）
最后选 Done 保存

5.2 手动配置方式

如果你不喜欢交互方式，也可以手动配置：

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

依次设置：

feishu_app_id
feishu_app_secret
feishu_domain
feishu_connection_mode

这种方式适合自动化部署。

6.1 清理旧容器

docker rm -f hermes

避免端口冲突。

6.2 启动服务

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

当看到如下日志时：

[Gateway] feishu gateway connected

说明连接成功。

7.1 私聊机器人

在飞书中：

通讯录 → 机器人 → Hermes AI

发送消息即可开始对话。

7.2 群聊使用

操作流程：

创建群聊
添加机器人
发送消息或 @机器人

8.1 机器人不回复

请依次检查：

应用是否已发布
App ID / Secret 是否正确
容器是否运行

8.2 群聊不生效

可能原因：

未开启群聊权限
require_mention 设置为 true

8.3 调试建议

 
  
    
     
     docker logs -f hermes 
    
 重点查看错误信息。

通过本文的讲解，你已经掌握了从部署 Hermes Agent 到接入飞书机器人的完整流程。这套方案的核心优势在于简单、高效、可扩展，非常适合个人开发者和企业内部使用。

如果你希望进一步提升系统能力，可以尝试引入 RAG、工具调用、甚至多 Agent 协作，让你的 AI 助手真正成为生产力工具。

Hermes Agent GitHub 仓库
飞书开放平台官方文档
Docker 官方文档