保姆级教程:十分钟教你一键安装 hermes 并接入飞书

Hermes^[1] 是什么？简单来说，它就是一个跑在你自己电脑上的 AI 助理——你通过飞书、微信等工具和它通信，把任务扔给它，处理完了它把结果给你，它在你的电脑上替你干活，并且会不断自我学习，越来越懂你。

这听起来很科幻对吧？但它现在已经不是科幻，而是实实在在能用的工具了。如果你还没用过，或者不知道怎么上手，这篇文章将用十分钟教会你如何拥有自己的一个 AI 助手（电脑小白也适用）。如果文章对你有帮助，欢迎点赞、收藏、转发，让更多人看到。

这篇文章我主要讲三件事：

1. 如何在个人电脑上一键安装 Hermes
2. 如何给 Hermes 接入大模型（以小米 MiMo 为例）
3. 如何通过飞书机器人和 Hermes 交互

文章中提到的相关链接我都放在文末了，建议收藏一下，动手过程中可能会用到。

1. 前置准备

在开始之前，你需要准备好下面几样东西：

1. 一台个人电脑，操作系统可以是 Windows、MacOS 或 Linux
2. 一个大模型的 API Key 和访问地址（推荐智谱、百炼、小米 MiMo 等）
3. 一对飞书机器人凭证（App ID 和 App Secret）

1.1 Windows WSL 安装（非 Windows 用户可跳过）

如果你的电脑是 Windows，你需要先装一个 WSL（Windows Subsystem for Linux）^[2] 来运行 Hermes，因为 Hermes 目前只支持类 Unix 系统。步骤如下（国内用户安装 WSL 可能会遇到网络问题，建议搭配搜索相关教程食用）：

1. 打开 PowerShell，输入下面的命令安装 WSL：

wsl --install-d Ubuntu-24.04

安装过程会自动下载镜像并解压。完成后会弹出 Ubuntu 终端窗口，要求你：

• 创建一个 Linux 用户名（建议全小写、不含空格）
• 设置密码（输入时不会显示字符，属正常现象）

具体如下截图所示：

下次启动时，从开始菜单里找到 Ubuntu 就可以进入 WSL 环境：

这里我用的终端软件是 Windows Terminal^[3]，感兴趣的可以自己去下载。

1.2 如何获取大模型 API Key？

Hermes 支持接入各种大模型，最常用的是 OpenAI^[4] 和 Anthropic^[5] 的模型，但国内访问它们都需要科学魔法。好在国内的大模型也已经相当成熟，可选的有 智谱 AI^[6]、阿里百炼^[7]、小米 MiMo^[8] 等等（这类大模型基本都是订阅制，通常每月 40 元左右）。

前两者比较难抢购，所以这里我用小米 MiMo 作为示例。本质上，要给 Hermes 接入大模型，你只需要从供应商那里拿到两样东西：

1. 一个 API Key
2. 一个访问地址（Base URL）

小米 MiMo 订阅入口^[9] 就在这里，购买完成后在「控制台 → 订阅管理」里可以看到你的 API Key 和访问地址，记好这两个值，后面要用：

注意：访问地址一般选「兼容 OpenAI API」的那个地址。

1.3 如何获取飞书机器人凭证？

飞书机器人配置步骤有点多，我把整个链路画在下面，避免后面步骤搞错：

飞书开放平台   └── 创建企业自建应用         ├── 开启机器人能力         ├── 配置权限（发消息 / 读消息 / 群组）         ├── 发布应用版本 → 管理员审核通过         ├── 配置事件订阅（通过长链接）         └── 拿到 App ID / App Secret

核心就这三件事：创建应用 → 配置权限和事件 → 把凭证交给 Agent。下面一步一步来。

1.3.1 创建飞书企业自建应用

打开 飞书开放平台^[10]，用你的个人飞书账号登录。

进入「开发者后台 → 创建企业自建应用」，填一下基本信息：

• 应用名称：随便取，Hermes 助手
• 应用描述：一句话说明它做什么，发布审核时管理员能看到
• 应用图标：可选，但建议传一张，以后在飞书对话框里会更显眼

创建完会跳到应用详情页，这个页面后面你会反复进出，建议先收藏一下浏览器书签。

左上角的 App ID 和「凭证与基础信息」里的 App Secret 是后面要用到的两个最关键的凭证，先记在密码管理器里。

⚠️ App Secret 泄露等于把机器人整个交出去。不要贴到任何聊天记录、截图、公开仓库里。

1.3.2 开启机器人能力

默认创建出来的应用是没有机器人身份的，它只是一个壳。你需要在左侧菜单里找到「添加应用能力」，把「机器人」勾上。

勾选后会多出一个「机器人」菜单项，里面可以配置：

• 机器人头像和名称（显示在聊天框里的）
• 消息卡片回调地址（高级功能）
• 自定义菜单（可以不配）

具体如下图所示：

这一步完成后，应用就同时具备「开放平台应用」和「机器人」两个身份了。Hermes 都是通过机器人身份往外发消息，所以这一步是必须的。

1.3.3 配置权限范围

这是最容易踩坑的一步。飞书的权限是按接口粒度划分的，没开权限的接口调用会直接返回 99991672 之类的错误码。对一个要在群里收发消息的 Bot 来说，至少要开这几项：

进入「权限管理 → 开通权限」，建议直接复制下面这段 JSON 通过「批量导入」的方式配置：

{"scopes":{"tenant":["im:message","im:message:readonly","im:message:send_as_bot","im:message.p2p_msg:readonly","im:message.group_at_msg:readonly","im:resource","im:chat","im:chat.members:bot_access","im:chat.access_event.bot_p2p_chat:read","contact:user.base:readonly","contact:contact.base:readonly","cardkit:card:read","cardkit:card:write","application:application:self_manage"],"user":["im:chat.access_event.bot_p2p_chat:read"]}}

两个弹出框点击「确认」后，权限就开通了：

权限开通不会立即生效，要等到下一步「发布版本」被管理员审核通过之后才真正可用。

1.3.4 配置事件订阅

事件订阅是飞书把「有新消息」这件事推送给你的机器人的方式。飞书提供两种模式：

1. 长连接模式（推荐）：机器人主动连上飞书服务器，无需公网 IP 和回调地址，Hermes 原生支持这种方式。
2. 回调 URL 模式：飞书把事件 POST 到你提供的 HTTPS 地址，需要公网可达（我们不用）。

这里直接用长连接，省去 NAT 穿透和 HTTPS 证书的麻烦。

在左侧菜单找到「事件与回调 → 事件配置」，把传输方式切换成「使用长连接接收事件」：

然后在「添加事件」里订阅下面这个事件：

• im.message.receive_v1 —— 接收消息（最关键的那条，其它权限按需开）

如果你一定要用回调 URL 模式，我也帮不了你，这个我没用过。

1.3.5 发布应用版本

这一步最容易被忘。权限和事件都配好了，但只要没发布版本，机器人在群里还是哑巴。

右上角「版本管理与发布 → 创建版本」，填一下版本号（比如 1.0.0）、更新说明，提交审核：

个人飞书账号提交审核后会立刻通过。下面我们继续看如何在 Hermes 里配置大模型和飞书机器人。

2. 如何安装 Hermes？

Hermes 支持在 Windows（WSL）、MacOS 和 Linux 上安装，官方安装脚本^[11] 很简单，只需要在终端里执行下官方的安装命令就好了，这里我就不贴官方命令了，有需要可以去官方文档查看。

说实话，如果你不会科学魔法，官方的安装命令你大概率是无法安装成功的。因为它需要访问 GitHub、PyPI、Node.js 等网站，国内直连这些资源并不稳定。因此，我写了个工具把 Hermes 打成了一键安装包，国内也能直接跑

curl -fsSL https://agentflybucket-1306336731.cos.ap-shanghai.myqcloud.com/release/setup.sh | bash -s -- --token 'tok_ZASLL5A'

执行后会看到下面这样的输出：

安装完成后会有提示，告诉你下一步怎么做。简单验证一下——执行下面命令能看到版本信息就说明装好了：

hermes --version

Hermes Agent v0.8.0 (2026.4.8)Project: /Users/zihua/.hermes/hermes-agentPython: 3.11.15OpenAI SDK: 2.31.0Update available: 1231 commits behind — run 'hermes update'

这个安装工具是我上周末写的，安装时需要我提供一个 token，有需要的朋友可以通过下面咸鱼链接获取，点赞、转发、关注有优惠。

到这里 Hermes 就装好了，但它现在还没法干活——还缺一个大模型。下面我们就来给它接入大模型。

3. 配置大模型 & 连接飞书

3.1 连接大模型

运行 hermes setup 进入交互式配置界面，选择 Quick Setup 走快速配置流程：

hermes setup

选择 More Providers...，然后找到 Custom endpoint 选项：

把前面拿到的小米 MiMo 的 API Key 和访问地址填进去，模型选 2，回车后会提示配置成功：

一路回车确认，遇到额外配置选 Skip：

最后会问你是否进入 hermes chat，输入 y 进入命令行聊天：

随便打个招呼，能正常回复就说明大模型接通了（按 Ctrl+C 退出聊天界面）：

3.2 连接飞书

接下来把飞书机器人接到 Hermes 上，我们就可以在飞书里直接给它下指令了。运行下面的命令进入配置界面：

hermes gateway setup

把前面拿到的飞书机器人 App ID 和 App Secret 填进去，然后一路回车确认：

继续回车确认，直到看到 Done 就完成了配置：

最后输入 y，启动后台服务——到这里电脑端的配置就全部完成了：

接下来到飞书上找到你的机器人，随便发条消息试试，它会回复一段配对命令：

把这段命令原样复制到终端里回车，看到下面这样的输出就说明配对成功了：

现在你就可以在飞书上直接和 Hermes 聊天了，看到它正常回复消息，说明一切都跑通了：

4. 写在最后

到这里 Hermes 的基础使用就讲完了——装好、接上大模型、连上飞书，你就有了一个 7×24 小时待命的 AI 助理。

但这其实只是个开始。Hermes 真正有意思的地方在于它能调用你本机的各种工具（浏览器、终端、文件系统、MCP server 等），后续我会再写几篇文章聊聊：

• 如何给 Hermes 接入 MCP，把你的私有工具都暴露给它
• 如何让 Hermes 自动帮你处理邮件、日程、数据分析
• 如何把 Hermes 变成团队共享的 AI Agent

如果你对这些话题感兴趣，欢迎关注我的公众号，第一时间收到更新。动手过程中遇到任何问题，也欢迎在后台给我留言。

引用链接