主题
Hermes 配置 Firecrawl 网页搜索
本文记录如何为 Windows 版 Hermes Agent CN Desktop 获取并配置 FIRECRAWL_API_KEY，用于 web_search 搜索和网页正文提取。
结论
配置分为四步：
- 注册 Firecrawl 免费账号并创建 API Key。
- 将 Key 写入 Hermes 的
.env文件。 - 在
config.yaml中指定 Firecrawl 搜索和提取后端。 - 完全重启 Hermes Desktop，并执行真实搜索验证。
WARNING
API Key 属于敏感信息，不要发送到聊天、截图、公开笔记或 Git 仓库中。
获取 Firecrawl API Key
- 打开 Firecrawl 官网。
- 点击 Start for free 或 Sign up，使用 GitHub、Google 或邮箱注册。
- 登录后进入 API Keys 页面。
- 点击 Create API Key，复制生成的 Key。
Key 的格式通常类似：
text
fc-xxxxxxxxxxxxxxxx如果 API Keys 直达链接无法打开，可先进入官网并登录，再从控制台侧栏进入 API Keys。
Firecrawl 的免费额度和计费规则可能调整，使用前以官方定价页为准。
配置 Hermes Desktop
当前 Windows 桌面版使用的 Hermes Home 是：
text
D:\software\hermes\Hermes Agent CN Desktop\data\hermes-home1. 写入 .env
打开：
text
D:\software\hermes\Hermes Agent CN Desktop\data\hermes-home\.env在文件末尾新增：
bash
FIRECRAWL_API_KEY=你的实际Key注意：
- 等号两边不要留空格。
- 不要添加中文引号。
- 一个环境变量占一行。
- 不要把 Key 写入
config.yaml。 - 不要把真实 Key 写入本仓库中的 Markdown 文件。
2. 指定搜索后端
打开：
text
D:\software\hermes\Hermes Agent CN Desktop\data\hermes-home\config.yaml加入：
yaml
web:
search_backend: firecrawl
extract_backend: firecrawl其中：
search_backend：负责搜索网页并返回标题、链接和摘要。extract_backend：负责读取指定网页的正文内容。
如果文件中已经存在 web:，不要再创建第二个同名节点，只需把两个字段合并到原来的 web: 下。
让配置生效
- 保存
.env和config.yaml。 - 完全退出 Hermes Agent CN Desktop。
- 检查系统托盘，确认 Hermes 相关进程已经退出。
- 重新启动桌面版。
- 新建对话。
首次配置建议完整重启应用，而不只是新建会话。
验证
重启后，可在 Hermes 中输入：
text
搜索 Firecrawl 官方网站最近的更新，并给出来源链接。然后继续测试网页提取：
text
读取其中一条 Firecrawl 官方链接，概括正文并标明来源。验证成功应同时满足：
- 能返回真实搜索结果和来源 URL。
- 能读取指定网页正文，而不是只根据标题或摘要作答。
- 日志中没有
FIRECRAWL_API_KEY缺失或 Web backend 未配置的错误。
常见问题
Web 工具已启用，但无法搜索
“Web 工具集已启用”只表示工具入口可用，不代表搜索服务已完成配置。仍需提供 FIRECRAWL_API_KEY，并指定 Firecrawl 后端。
修改后没有生效
依次检查：
- Key 是否写入了当前桌面版实际使用的
.env。 - 环境变量名是否准确写成
FIRECRAWL_API_KEY。 - YAML 缩进是否正确。
- 是否完全退出并重启了 Hermes Desktop。
- 是否新建了会话。
是否需要配置 FIRECRAWL_API_URL
使用 Firecrawl 官方云服务时通常不需要。Hermes 默认连接官方 API。只有自建 Firecrawl 服务时才需要额外设置：
bash
FIRECRAWL_API_URL=https://你的自建服务地址