Hermes在云服务器上的安装部署踩坑指南

Hermes 介绍

Hermes Agent 是由 Nous Research 开源的自主 AI 智能体框架，2026 年最受关注的开源 Agent 项目之一。

它最核心的特点是跨会话持久记忆——普通 AI 每次对话结束就"失忆"，而 Hermes 能记住你之前说过的事、做过的任务、给过的反馈，真正做到越用越聪明。

除此之外，它还支持自进化：通过内置的"自进化闭环"机制，Agent 会从历史交互中不断学习，自动优化自己的行为模式。

部署方式也很灵活，可以跑在自己的服务器上 24/7 运行，数据完全私有可控，并且原生支持接入飞书、Slack 等主流协作平台。

简单说：Hermes = 有记忆 + 会进化 + 可私有部署的开源 AI Agent。

安装 Hermes

中文版官方文档：https://hermes-doc.aigc.green/getting-started/installation
中文社区镜像文档：https://hermesagent.org.cn/docs/getting-started/installation

踩坑①：直接用官方脚本安装，大概率网络超时

官方给的安装命令走的是 GitHub raw 地址，国内访问基本超时：

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

推荐改用中文社区的镜像脚本，速度稳定：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

安装完成后进入配置流程，第一次安装直接选快速安装，回车继续：

配置大模型：输入对应序号选择模型提供商。这里以 MiniMax 为例，选 21，然后输入 API Key（注意：输入时终端不会显示字符，正常现象）：

踩坑②：Base URL 要手动改成 MiniMax 的地址，默认值不对：

https://api.minimaxi.com/v1

选择 MiniMax 2.7 模型：

按 1 进入平台配置：

选 11 接入飞书：

按 2 选择手动输入 App ID 和 App Secret：

打开飞书开放平台，创建企业自建应用：

https://open.feishu.cn/

在「凭证与基础信息」里找到 App ID 和 App Secret，复制粘贴到终端：

连接方式选 WebSocket（长连接，不需要公网 IP）：

个人私聊机器人选第二个：

选 1 个人使用：

回车确认：

选第二个开机自启，省去每次手动启动的麻烦：

回车启动服务：

终端配置完成。输入 hermes 验证安装：

出现以下界面说明配置成功：

飞书侧配置：打开飞书开发者后台，找到「添加应用能力」，点击机器人：

打开权限管理，导入以下权限配置：

{ "scopes": { "tenant": [ "contact:contact.base:readonly", "docx:document:readonly", "im:chat:read", "im:chat:update", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message.pins:read", "im:message.pins:write_only", "im:message.reactions:read", "im:message.reactions:write_only", "im:message:readonly", "im:message:recall", "im:message:send_as_bot", "im:message:send_multi_users", "im:message:send_sys_msg", "im:message:update", "im:resource", "application:application:self_manage", "cardkit:card:write", "cardkit:card:read" ], "user": [ "contact:user.employee_id:readonly", "offline_access", "base:app:copy", "base:field:create", "base:field:delete", "base:field:read", "base:field:update", "base:record:create", "base:record:delete", "base:record:retrieve", "base:record:update", "base:table:create", "base:table:delete", "base:table:read", "base:table:update", "base:view:read", "base:view:write_only", "base:app:create", "base:app:update", "base:app:read", "board:whiteboard:node:create", "board:whiteboard:node:read", "calendar:calendar:read", "calendar:calendar.event:create", "calendar:calendar.event:delete", "calendar:calendar.event:read", "calendar:calendar.event:reply", "calendar:calendar.event:update", "calendar:calendar.free_busy:read", "contact:contact.base:readonly", "contact:user.base:readonly", "contact:user:search", "docs:document.comment:create", "docs:document.comment:read", "docs:document.comment:update", "docs:document.media:download", "docs:document:copy", "docx:document:create", "docx:document:readonly", "docx:document:write_only", "drive:drive.metadata:readonly", "drive:file:download", "drive:file:upload", "im:chat.members:read", "im:chat:read", "im:message", "im:message.group_msg:get_as_user", "im:message.p2p_msg:get_as_user", "im:message:readonly", "search:docs:read", "search:message", "space:document:delete", "space:document:move", "space:document:retrieve", "task:comment:read", "task:comment:write", "task:task:read", "task:task:write", "task:task:writeonly", "task:tasklist:read", "task:tasklist:write", "wiki:node:copy", "wiki:node:create", "wiki:node:move", "wiki:node:read", "wiki:node:retrieve", "wiki:space:read", "wiki:space:retrieve", "wiki:space:write_only" ] }}

「事件与回调」选择长连接，添加事件选接收消息：