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

目录前言1 项目概述1.1 项目确认1.2 Hermes Agent 能做什么2 环境准备2.1 Docker 安装验证2.2 环境建议3 使用官方镜像部署 Hermes3.1 拉取镜像3.2 创建数据目录3.3 初始化配置3.4 启动 Web 服务3.5 CLI 模式体验4 飞书机器人创建流程4.1 进入开发者平台4.2 创建企业自建应用4.3 获取关键凭证4.4 添加机器人能力4.5 发布应用5 Hermes 接入飞书5.1 使用向导配置5.2 手动配置方式6 启动飞书网关6.1 清理旧容器6.2 启动服务6.3 日志检查7 实际使用方法7.1 私聊机器人7.2 群聊使用8 常见问题8.1 机器人不回复8.2 群聊不生效8.3 调试建议结语参考资料前言在 AI 技术快速发展的今天将大模型能力接入企业办公系统已经成为一种趋势。无论是智能问答、自动化办公还是企业知识库AI 助手都能极大提升效率。而如何快速、稳定地部署一个可用的 AI 系统是许多开发者面临的第一道门槛。本文将围绕开源项目 Hermes Agent手把手带你完成从部署到接入飞书机器人的完整流程。相比零散教程本文不仅提供详细步骤还会补充关键原理说明与实践建议帮助你真正掌握这套方案。1 项目概述1.1 项目确认在开始之前我们先确认所使用的项目信息仓库NousResearch/hermes-agentGitHubhttps://github.com/NousResearch/hermes-agentDocker 镜像nousresearch/hermes-agent该项目提供了完整的 Agent 框架并内置 Gateway可用于对接飞书等平台。1.2 Hermes Agent 能做什么Hermes Agent 本质上是一个 AI 调度系统它具备以下能力接入多种大模型OpenAI、Ollama、Anthropic 等支持对话记忆与上下文管理提供 Web UI 与 CLI支持平台接入飞书、Slack 等你可以把它理解为模块作用LLM提供语言理解与生成能力Agent负责逻辑控制与任务调度Gateway负责对接外部平台2 环境准备2.1 Docker 安装验证首先确保你已经安装 Dockerdocker--version如果能正常输出版本号说明安装成功。2.2 环境建议为了保证运行稳定建议环境如下项目推荐配置CPU2核及以上内存4GB 以上网络可访问外网系统Linux / macOS如果你使用本地模型如 Ollama则需要更高配置。3 使用官方镜像部署 Hermes3.1 拉取镜像dockerpull nousresearch/hermes-agent:latest这是官方提供的镜像包含完整运行环境。3.2 创建数据目录mkdir-p~/.hermes该目录用于存储配置文件对话记忆日志数据这一步非常重要否则数据不会持久化。3.3 初始化配置dockerrun-it--rm\-v~/.hermes:/opt/data\nousresearch/hermes-agent\setup执行后会进入交互式配置流程。你需要填写LLM 提供商如 OpenAIAPI Key模型名称例如配置项示例ProvideropenaiModelgpt-4API Keysk-xxxx3.4 启动 Web 服务dockerrun-d\--namehermes\--restartalways\-p8000:8000\-v~/.hermes:/opt/data\nousresearch/hermes-agent\hermes gateway run访问地址http://localhost:8000你可以通过浏览器直接使用 Hermes。3.5 CLI 模式体验dockerrun-it--rm\-v~/.hermes:/opt/data\nousresearch/hermes-agentCLI 模式适合调试或快速测试。4 飞书机器人创建流程4.1 进入开发者平台打开飞书开放平台https://open.feishu.cn/登录后进入开发者后台。4.2 创建企业自建应用填写基本信息应用名称Hermes AI应用描述AI 助手创建后进入应用详情页。4.3 获取关键凭证在“凭证与基础信息”中获取App IDApp Secret注意Secret 只会显示一次务必保存。4.4 添加机器人能力左侧菜单添加能力→机器人→添加进入机器人设置开启启用机器人消息模式私聊 群聊权限全部权限或按需4.5 发布应用左侧版本管理与发布→创建版本填写版本信息随便填→保存点击发布企业内应用无需审核立即生效5 Hermes 接入飞书5.1 使用向导配置dockerrun-it--rm-v~/.hermes:/opt/data nousresearch/hermes-agent gateway setup按照提示填写平台列表选择feishu国内飞书App ID粘贴你刚才的cli_xxxxxxApp Secret粘贴你的密钥Domain直接回车默认feishuConnection mode直接回车默认websocket最稳定Allowed User IDs留空 → 下一步Authentication输入1允许所有人使用最后选Done保存5.2 手动配置方式如果你不喜欢交互方式也可以手动配置dockerrun-it--rm-v~/.hermes:/opt/data nousresearch/hermes-agent\configsetfeishu_app_id cli_xxxxxx依次设置feishu_app_idfeishu_app_secretfeishu_domainfeishu_connection_mode这种方式适合自动化部署。6 启动飞书网关6.1 清理旧容器dockerrm-fhermes避免端口冲突。6.2 启动服务dockerrun-d\--namehermes\--restartalways\-p8000:8000\-v~/.hermes:/opt/data\nousresearch/hermes-agent\gateway run6.3 日志检查dockerlogs-fhermes当看到如下日志时[Gateway] feishu gateway connected说明连接成功。7 实际使用方法7.1 私聊机器人在飞书中通讯录 → 机器人 → Hermes AI发送消息即可开始对话。7.2 群聊使用操作流程创建群聊添加机器人发送消息或 机器人8 常见问题8.1 机器人不回复请依次检查应用是否已发布App ID / Secret 是否正确容器是否运行8.2 群聊不生效可能原因未开启群聊权限require_mention 设置为 true8.3 调试建议dockerlogs-fhermes重点查看错误信息。结语通过本文的讲解你已经掌握了从部署 Hermes Agent 到接入飞书机器人的完整流程。这套方案的核心优势在于简单、高效、可扩展非常适合个人开发者和企业内部使用。如果你希望进一步提升系统能力可以尝试引入 RAG、工具调用、甚至多 Agent 协作让你的 AI 助手真正成为生产力工具。参考资料Hermes Agent GitHub 仓库飞书开放平台官方文档Docker 官方文档