--- title: "W10 说明：把 Hermes Agent 接上飞书" --- # 🛠 把 Hermes Agent 接上飞书 [W10 材料入口](https://ai.lingnan.top/materials/2026-autumn/w10) · [上一篇：在 Windows 上装好 Hermes Agent](https://ai.lingnan.top/materials/2026-autumn/w10/hermes-install) ## 要做成什么 在手机飞书里给自己的机器人发消息，电脑上的 Hermes 收到后干活，再把结果回到飞书。全程约 15 分钟，其中扫码建机器人和配对要在手机上操作；最后一节把网关设成登录 Windows 后自动在后台运行。 Hermes 用**长连接**（WebSocket）接飞书：电脑上的 Hermes 主动连到飞书的服务器，飞书顺着这条连接把你的消息送过来。官方文档里另一种接法 Webhook 要飞书从外网把消息推到你电脑上的一个网址，个人电脑没有公网地址，这里不用它。 - **准备**：[上一篇](https://ai.lingnan.top/materials/2026-autumn/w10/hermes-install)装好的 Hermes（Windows）；手机上装好飞书并登录，电脑上不用登录飞书。 - **Mac**：本页在 Windows 上做过一遍，没在 Mac 上测过。官方文档里 Mac 用同样的命令（`hermes gateway setup`、`hermes pm install --extra feishu`、`hermes gateway`、`hermes gateway install`），新开标签页用 `Command+T`，链接用 `Command` 加单击打开。 - **🤖 让智能体帮忙**：卡住时，把这一节、报错原文和官方文档 [Feishu / Lark](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/feishu) 一起交给 WorkBuddy 或 Claude Code。App Secret 由设置程序自动保存，**不贴进任何对话**。 ## 🎬 跟做视频 视频 3 分 38 秒，等待部分已加速，录的是下面第 2.1–2.3 节；手机上的两步用截图代替，授权码、二维码、App ID、配对码已打码。第 2.5 节开机自动启动没有录，照图文做。 ## 第 2 章 接上飞书 ### 2.1 扫码建机器人 **第 1 步：运行设置。** 右键开始按钮，选 **终端**，输入下面这行，回车： ```powershell hermes gateway setup ``` 出现一长串聊天平台，输入 `8`（`Feishu / Lark`）回车。编号以你屏幕上为准。接着问怎么建机器人，直接回车，选第 1 项 `Scan QR code to create a new bot automatically`（扫码自动建）。 ![选 Feishu / Lark，再选扫码建机器人](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-01-choose-scan.png) **第 2 步：打开链接，用手机飞书扫码。** 终端显示 `Open this URL in Feishu / Lark on your phone:` 和一个以 `https://open.feishu.cn/page/launcher?user_code=` 开头的链接，下面是 `Fetching configuration results...`，它在等你确认，不要关窗口。按住 `Ctrl` 点这个链接，浏览器会打开飞书的“扫码登录”页，用手机飞书扫页面上的二维码，在手机上点确认。 ![终端里显示的链接，按住 Ctrl 单击打开（授权码已打码）](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-02-terminal-link.webp) ![浏览器里的扫码登录页（二维码已打码）](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-03-browser-qr.png) ![扫码成功，在手机上确认登录](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-04-scan-ok.png) 链接里的 `user_code` 是这次授权用的一次性码，不要发给别人。 **第 3 步：在浏览器里建应用。** 手机确认后，浏览器跳到“创建 Hermes Agent 飞书应用”。选一个头像，名称改成你记得住的名字（本例 `Hermes 助手`，默认是“用户××的智能助手”），点 **立即创建**。看到“创建成功”就可以回到终端，浏览器页面不用再点。 ![给机器人起名字，点“立即创建”](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-05-create-app.png) ![创建成功](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-06-created.png) **第 4 步：回终端答三问。** 终端里出现 `Bot created: Hermes 助手`，App ID 和 App Secret 已经自动存进 Hermes 的配置文件，不用你复制粘贴。接着照下表回答： | 窗口里问 | 你输入 | 说明 | | --- | --- | --- | | `How should direct messages be authorized?` | 直接回车 | 默认第 1 项“配对批准”：别人私聊机器人，要你在电脑上批准才能用，见第 2.3 节 | | `How should group chats be handled?` | 直接回车 | 默认第 1 项：在群里要 @ 它才回 | | `Home chat ID (optional, for cron/notifications):` | 直接回车 | 先留空，第 2.3 节在飞书里设 | ![Bot created，私聊选配对批准](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-07-bot-created-dm.png) 看到 `Feishu / Lark configured!`，下面列出 `App ID`、`Domain: feishu`（国内版飞书）、`Bot: Hermes 助手`，就配好了。它又回到平台列表，直接回车（默认 `Done`）退出。最后一行可能显示 `No platforms configured`，不用管，配置已经存好，下一步启动时会用上。 ![Feishu / Lark configured（App ID 已打码）](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-08-configured.webp) 官方文档：[Feishu / Lark](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/feishu)（Step 1 的 Scan-to-Create），中文版 [飞书 / Lark](https://hermes-agent.nousresearch.com/docs/zh-Hans/user-guide/messaging/feishu)，中英文不一致时以英文页为准。 🤖 浏览器里的页面和截图对不上时，把页面截图（遮住二维码）和官方飞书页链接交给智能体，让它告诉你点哪里。 ### 2.2 装飞书组件，启动网关 **第 1 步：装飞书组件。** 在同一个终端里运行： ```powershell hermes pm install --extra feishu ``` 约 1 分钟，看到 `venv +feishu` 就装好了。这一步要先做：不装就直接启动网关，它会停下来问 `Install it now? [Y/n]`，两分钟没人回答，网关会自己退出。 ![装好飞书组件](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-09-pm-feishu.png) **第 2 步：启动网关。** 运行： ```powershell hermes gateway ``` 十几秒后出现一行 `[Lark] ... connected to wss://msg-frontier.feishu.cn/...`，长连接就建好了。上面那行黄色的 `WARNING ... No env user allowlists configured` 是提醒你还没写允许名单，我们用配对批准，不用管。 ![网关连上飞书（连接参数已打码）](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-10-gateway.png) **这个窗口一直开着**：网关在这个窗口里运行，关掉窗口或按 `Ctrl+C`，飞书里的机器人就不回了。电脑睡眠也一样。让它开机后自动在后台运行，见第 2.5 节。 ### 2.3 手机上配对，第一次对话 **第 1 步：给机器人发任意一句话。** 在手机飞书顶部搜索机器人的名字（本例 `Hermes 助手`），打开对话，发一句“你好”。它会回一段英文：还不认识你，并给出一个 8 位配对码（`Your pairing code`，1 小时内有效）和一行要你运行的命令。 ![机器人回复配对码（配对码已打码）](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-11-phone-code.webp) **第 2 步：在电脑上批准。** 回到电脑，在终端窗口里按 `Ctrl+Shift+T` 新开一个标签页（网关那个标签页别关），输入机器人给的命令，把最后的配对码换成你收到的： ```powershell hermes pairing approve feishu 你的配对码 ``` 看到 `Approved! User ou_… on feishu can now use the bot~` 就批准好了。`ou_` 开头的是你在这个机器人下的飞书用户编号。 ![批准配对（配对码和用户编号已打码）](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-12-approve.png) **第 3 步：再发一次消息。** 回到手机，再发一句话。这次它先提示 `No home channel is set for Feishu`，接着回答你的问题，对话就通了。 ![批准后重发，机器人回答](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-13-phone-chat.webp) 那条 home channel 提示的意思是：Hermes 还不知道定时任务的结果、跨平台的通知该发到哪个对话。在这个对话里发 `/sethome`，它就成了 Home Chat，以后设的定时任务结果会发到这里。不设也能正常聊天。 🤖 发了消息没回复时，把网关窗口最后几行（遮住 `access_key` 那一段）连同官方飞书页的 Troubleshooting 一节交给智能体。 ### 2.4 只认你 - 私聊用的是配对批准：别人搜到你的机器人发消息，只会拿到配对码，你不在电脑上批准，它就不干活。查看已批准和待批准的人：`hermes pairing list`。 - 群聊默认要 @ 机器人才回。 - App ID 和 App Secret 存在 `C:\Users\你的用户名\AppData\Local\hermes\.env`。App Secret 相当于机器人的密码，不截图、不发给别人；有人拿到它就能冒充你的机器人。 - 想写死允许名单，可以在 `.env` 里加 `FEISHU_ALLOWED_USERS=ou_…`，只放你自己的编号（批准时终端显示的那串）。官方文档：飞书页 [Security](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/feishu#security)、[Security · DM Pairing System](https://hermes-agent.nousresearch.com/docs/user-guide/security)。 ✅ 自查 - [ ] 网关窗口里有 `connected to wss://msg-frontier.feishu.cn` - [ ] 手机飞书私聊机器人能收到回答 - [ ] `hermes pairing list` 里能看到自己已批准 ### 2.5 开机自动启动，后台常驻 上面的网关跑在终端窗口里，关掉窗口它就停了。改成登录 Windows 后自动在后台运行，不用一直开着窗口： **第 1 步：停掉窗口里的网关。** 回到网关那个标签页，按 `Ctrl+C`，看到 `Gateway stopped.` 就停了。 **第 2 步：安装成后台任务。** 在这个窗口里运行： ```powershell hermes gateway install ``` 它会连问三句，照下表回答： | 窗口里问 | 你输入 | 说明 | | --- | --- | --- | | `Start the gateway now after install? [Y/n]` | 直接回车 | 装好就启动 | | `Start the gateway automatically on Windows login with a Scheduled Task? [Y/n]` | 直接回车 | 用 Windows 的“计划任务”在你登录后自动启动 | | `Open the UAC prompt now? [y/N]` | 输入 `y` 回车 | 创建计划任务要管理员批准一次 | 弹出“你要允许来自未知发布者的此应用对你的设备进行更改吗？”，程序名是 `python.exe`，点 **是**。官方 Windows 指南写这一步不需要管理员权限，v0.23.0 实际会要你批准这一次，以程序为准。 ![批准创建计划任务](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-15-uac.webp) 看到 `Launched elevated Hermes gateway install prompt.` 就装好了。 ![hermes gateway install 的三问](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-14-gateway-install.png) **第 3 步：核对。** 运行： ```powershell hermes gateway status ``` 显示 `Scheduled Task registered: Hermes_Gateway` 和 `Gateway process running (PID: …)`，网关就在后台跑着了。现在可以关掉所有终端窗口，飞书里的机器人照样回复。 **第 4 步：重启电脑验证。** 重启后登录 Windows，不用打开终端，等半分钟左右（计划任务在登录后 30 秒启动网关），在手机飞书里给机器人发一句话，它能回复就对了。想在电脑上看一眼，打开终端运行 `hermes gateway status`，结果和第 3 步一样。 ![重启后 hermes gateway status：计划任务已注册、网关在运行](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-16-status-after-reboot.png) ![重启后在飞书里发一句，机器人回复“网关在线”](/course-materials/2026-autumn/w10/hermes-feishu/hermes-feishu-18-reboot-reply.png) 几点说明： - 这是**登录 Windows 后**自动启动：电脑开着但停在登录界面、睡眠或关机时，机器人都不回。 - 停止、重启、取消自动启动分别用 `hermes gateway stop`、`hermes gateway restart`、`hermes gateway uninstall`（官方文档 [Windows (Native) Guide · Running the gateway at Windows login](https://hermes-agent.nousresearch.com/docs/user-guide/windows-native)）。改了 `.env` 或配置后运行 `hermes gateway restart` 生效。 - 网关的运行记录在 `C:\Users\你的用户名\AppData\Local\hermes\logs\gateway.log`，机器人不回时先看这里最后几行。 ✅ 自查 - [ ] 关掉所有终端窗口后，手机飞书私聊机器人仍有回复 - [ ] 重启电脑登录后不开终端，机器人也能回复 - [ ] `hermes gateway status` 显示计划任务已注册、网关在运行 ## 下一步 接上飞书以后，照下一篇[让 Hermes 能干：工具、技能、MCP、子代理](https://ai.lingnan.top/materials/2026-autumn/w10/hermes-skills)给它多加几样本事。