> 本教程包含 Hermes 安装与首次配置、接入飞书、网页抓取与结果写入三个主题。按步骤操作，并在每一步完成对应检查。
## 使用说明
---
## 教程 01｜Hermes Agent 安装与首次配置
### 教程目标
完成 Hermes Agent 的安装与首次配置，并通过实际结果验证。
### 开始前
### 步骤 1：确认系统环境与安装文档
Windows 需要先准备 WSL/Ubuntu，macOS 可以直接使用终端。开始前先确认系统前置条件和安装说明。
本步验收：能看到与截图相符的关键界面，并完成一次可回读的最小验证。
### 步骤 2：执行 Hermes 安装命令
在 Ubuntu 或 macOS 终端中复制并执行对应的一行安装命令，等待安装程序进入设置向导。
本步验收：安装程序正常运行，并进入后续配置流程。
### 步骤 3：进入快速配置向导
是否迁移 OpenClaw 配置按实际情况选择；首次安装可不迁移，然后进入 Quick Setup。
本步验收：能够进入 Quick Setup，并继续完成模型供应商配置。
### 步骤 4：发送消息验证模型连接
完成模型供应商配置后进入 Hermes 聊天界面，发送一条测试消息；收到正常回复才算安装和模型连接通过。
本步验收：测试消息能够获得正常回复。
### 完成检查
1. 目标工具或页面可以正常打开，关键界面与教程一致。
2. 已完成一次最小测试，并回读到预期结果。
3. 涉及账号、权限、公开内容或自动回复的操作，均在授权范围内单独确认。
---
## 教程 02｜把 Hermes Agent 接入飞书
### 教程目标
完成飞书企业自建应用创建、Hermes 网关配置、权限与事件配置，并在飞书工作台验证消息回复。
### 开始前
### 步骤 1：创建飞书企业自建应用
进入飞书开放平台开发者后台，新建企业自建应用。App ID 与 App Secret 只用于配置，不要放进公开教程截图。
本步验收：应用创建成功，并能进入应用管理页面。
### 步骤 2：运行 Hermes 网关配置
在 Ubuntu 或终端执行 Hermes gateway setup，选择飞书渠道，再按向导填写 App ID 与 App Secret。
本步验收：飞书渠道配置被正确保存，终端未出现阻断性错误。
### 步骤 3：导入应用权限并配置事件
在权限管理中批量导入所需权限配置，再到事件与回调中选择长连接，并添加消息事件与卡片回传交互。
本步验收：所需权限和事件均已出现在应用配置中。
### 步骤 4：在飞书工作台完成验证
发布新版本后，在飞书工作台打开自建应用发送测试消息；机器人正常回复后，接入才算完成。
本步验收：在飞书工作台发送测试消息后，机器人能够正常回复。
### 完成检查
1. 飞书应用已创建并完成必要配置。
2. Hermes 网关已连接飞书渠道。
3. 已在飞书工作台完成真实消息收发测试。
---
## 教程 03｜抓取网页信息并写入飞书文档
### 教程目标
完成网页抓取工具安装、API Key 配置、公开网页信息提取，并把结果写入飞书表格后回读验证。
### 开始前
### 步骤 1：获取 Firecrawl CLI 项目地址
找到 Firecrawl CLI 的项目地址后，将地址交给 Hermes 完成安装。它适合抓取反爬限制较弱的公开网页。
本步验收：Firecrawl CLI 安装完成，并能正常响应基础命令。
### 步骤 2：进入 Firecrawl 官网并打开 Dashboard
从 Firecrawl 官网进入 Dashboard，再打开 API Keys 页面创建密钥。教程截图只展示入口，不展示生成后的真实 Key。
本步验收：已创建可用密钥，并安全保存在本地配置中。
### 步骤 3：抓取并检查网页结果
向 Hermes 提供目标公开网页和明确的提取要求，先检查抓取结果、标题、链接与时间字段是否完整。
本步验收：返回结果非空，所需字段完整，链接可回访。
### 步骤 4：写入飞书表格并回读
完成飞书 CLI 授权后，让 Hermes 新建表格并写入抓取结果；随后打开链接回读字段和记录数。
本步验收：飞书表格中的字段、记录数与抓取结果一致。
### 步骤 5：用浏览器自动化处理更复杂页面
遇到简单抓取不稳定的页面，可改用 Playwright 类浏览器自动化工具；抓取后仍要写入飞书文档并回读验证。
本步验收：复杂页面数据能够稳定提取，并在飞书文档中完成回读。
### 完成检查
1. 抓取结果包含所需字段，且来源页面可以回访核对。
2. 写入飞书后已回读字段、记录数与内容。
3. 全程未公开真实密钥、令牌、验证码或私人数据。