需依次完成五步：一、执行安装脚本部署Hermes Agent并验证；二、配置一步API的OpenAI兼容模型；三、在飞书开放平台创建自建应用并申请必要权限；四、通过hermes gateway setup配置飞书网关，填写App ID/Secret并在飞书端设置事件订阅URL；五、导入FAQ等业务知识后启动服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在飞书平台快速部署一个7×24小时在线的智能客服机器人，但尚未完成Hermes Agent与飞书的对接，则可能是由于应用配置、网关设置或模型未就绪导致服务无法响应。以下是构建Hermes Agent客服机器人的具体操作路径：
一、部署Hermes Agent核心程序
该步骤确保本地或服务器端具备可运行的Hermes Agent环境，是后续所有集成的基础。安装过程自动处理依赖与命令注册，无需手动配置Python虚拟环境或Node.js版本。
1、打开终端（Linux/macOS）或WSL2中的Ubuntu终端（Windows用户）。
2、执行一键安装命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
3、安装完成后刷新shell环境：bash用户执行source ~/.bashrc，zsh用户执行source ~/.zshrc。
4、验证安装结果：输入hermes --help，出现帮助信息即表示安装成功。
二、配置大模型接入（解决空响应关键）
Hermes Agent本身不内置模型，必须绑定兼容OpenAI格式的API服务才能生成有效回复。若跳过此步，机器人将无法输出内容。
1、访问一步API控制台（yibuapi.com），登录后点击「创建 API-KEY」。
2、填写名称如“hermes-agent”，提交后复制生成的API Key（格式为sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx）。
3、在终端中运行hermes setup，按提示选择“Custom endpoint (OpenAI compatible)”作为模型提供商。
4、粘贴一步API的Base URL（如https://api.yibuapi.com/v1）及上一步复制的API Key。
5、确认默认模型名称（如gpt-4o-mini或MiMo V2 Pro）后完成配置。
三、创建并配置飞书企业自建应用
此步骤在飞书开放平台注册合法身份，赋予机器人读取消息、发送消息及识别用户的基本权限，是飞书侧准入前提。
1、访问https://open.feishu.cn，使用企业管理员账号登录。
2、点击“创建应用”→选择“企业自建应用”，填写名称（如“Hermes AI 客服”）和描述，完成创建。
3、进入应用详情页，点击“添加应用能力”→启用“机器人”。
4、进入“权限管理”→“申请权限”，勾选以下三项：im:message:send_as_bot、im:message:read、contact:user:readonly，保存后点击“发布”。
5、在“凭证与基础信息”页面，记录下App ID和App Secret，后续网关配置必需。
四、配置飞书网关与事件订阅
该步骤建立Hermes Agent与飞书之间的双向通信通道，使消息能被接收并响应。缺失任一环节都将导致消息无回执。
1、在已部署Hermes Agent的服务器终端中执行：hermes gateway setup。
2、向导中选择feishu作为网关类型。
3、依次填入第三步中记录的App ID与App Secret。
4、User IDs字段留空（允许全员访问）或填入测试用飞书用户ID。
5、Domain保持默认feishu，Connection mode选择websocket。
6、返回飞书开放平台，在“事件与回调”→“事件订阅”中，URL填写https://您的服务器IP:3000/webhook/feishu。
7、添加事件类型：im.message.receive_v1，系统将发起验证请求——此时需确保Hermes Agent正在运行。
五、导入业务知识并启动服务
仅完成通信链路仍不足以支撑客服场景，需注入领域知识以提升回答准确性与业务适配度。
1、准备结构化FAQ文档或产品说明书文本文件（支持TXT、PDF、MD格式）。
2、执行命令：hermes memory ingest --file ./faq.md，将内容载入Hermes记忆系统。
3、启动服务：hermes start，观察终端日志是否显示“Feishu gateway initialized”与“Webhook server listening”。
4、在飞书中搜索已创建的机器人名称，发送“你好”，确认收到结构化欢迎语或业务相关应答。
