> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-ul56gh.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> 在 Hermes Agent 中将 Firecrawl 用作默认的网页搜索和提取后端

<Note>
  **Hermes 官方文档：**[网页搜索](https://hermes-agent.nousresearch.com/docs/user-guide/features/web-search) · [浏览器](https://hermes-agent.nousresearch.com/docs/user-guide/features/browser)

  Nous Research 开发的 [Hermes Agent](https://hermes-agent.nousresearch.com/) 默认使用 Firecrawl 作为 `web_search` 和 `web_extract` 的后端。
</Note>

<h2 id="overview">
  概述
</h2>

Hermes Agent 是 Nous Research 推出的开源终端和桌面代理。它提供以下网页工具：

| 工具 | 功能 |
| - | - |
| **`web_search`** | 进行网页搜索并返回按相关性排序的结果 |
| **`web_extract`** | 获取并提取 URL 中的可读内容 |

Firecrawl 是搜索和提取功能的**默认**提供商。您可以设置 `FIRECRAWL_API_KEY`、使用自托管的 `FIRECRAWL_API_URL`，或使用 Nous 工具网关。如果您拥有多个提供商的凭据，可在 `hermes tools` 或 `config.yaml` 中选择 Firecrawl。通过 Firecrawl 云模式实现的浏览器自动化为可选功能。

<h2 id="quick-start">
  快速入门
</h2>

1. 前往 [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com/) 安装 Hermes Agent
2. 添加 Firecrawl 密钥：

```bash theme={null}
# ~/.hermes/.env
FIRECRAWL_API_KEY=fc-your-key-here
```

在 [firecrawl.dev](https://www.firecrawl.dev/app/api-keys) 获取密钥。

3. 或通过交互式方式配置：

```bash theme={null}
hermes tools
```

选择 **网页搜索和提取** → **Firecrawl**。

4. 验证：

```bash theme={null}
hermes setup
```

<h2 id="capabilities">
  功能
</h2>

| 功能 | Hermes 中的支持情况 |
| - | - |
| **搜索** | 默认使用 `web_search` 后端 |
| **提取 / 抓取** | 默认使用 `web_extract` 后端 |
| **浏览器** | 可选的 Firecrawl 云浏览器提供商 |

<h3 id="use-firecrawl-for-one-capability-only">
  仅使用 Firecrawl 的一种能力
</h3>

Hermes 支持分别选择搜索和提取后端，因此你可以将免费搜索后端与 Firecrawl 提取功能搭配使用 (反之亦然) ：

```yaml theme={null}
# ~/.hermes/config.yaml
web:
  search_backend: "searxng"
  extract_backend: "firecrawl"
```

当这些键为空时，两者都会使用 `web.backend`，随后 Hermes 会根据可用凭据自动检测。自动检测时，其他提供商的凭据可能会优先于 Firecrawl；因此，如需确保使用 Firecrawl，请显式设置 `search_backend`、`extract_backend` 或 `web.backend`。

<h3 id="browser-cloud-mode">
  浏览器云模式
</h3>

要使用 Firecrawl 实现浏览器自动化：

```bash theme={null}
# ~/.hermes/.env
FIRECRAWL_API_KEY=fc-your-key-here
```

```bash theme={null}
hermes setup tools
# → 浏览器自动化 → Firecrawl
```

可选：

```bash theme={null}
# 自托管 Firecrawl（不设置则默认使用云端 API）
FIRECRAWL_API_URL=http://localhost:3002

# 会话 TTL，单位为秒（默认值：300）
FIRECRAWL_BROWSER_TTL=600
```

<h2 id="nous-portal-managed-firecrawl">
  Nous Portal (托管 Firecrawl)
</h2>

订阅付费版 [Nous Portal](https://portal.nousresearch.com/) 后，可通过 Hermes **工具网关**使用托管 Firecrawl 进行网页搜索和提取，无需单独的 Firecrawl 密钥：

```bash theme={null}
hermes setup --portal
```

已安装的版本可通过 `hermes tools` 启用网页工具。

<h2 id="self-hosted-firecrawl">
  自托管 Firecrawl
</h2>

```bash theme={null}
# ~/.hermes/.env
FIRECRAWL_API_URL=http://localhost:3002
```

设置 `FIRECRAWL_API_URL` 后，如果 Firecrawl 服务器已禁用身份验证 (在 Firecrawl 实例上设置 `USE_DB_AUTHENTICATION=false`) ，则无需 API 密钥。

<h2 id="resources">
  资源
</h2>

* [Hermes Agent](https://hermes-agent.nousresearch.com/)
* [Hermes 网页搜索文档 (默认使用 Firecrawl) ](https://hermes-agent.nousresearch.com/docs/user-guide/features/web-search#firecrawl-default)
* [Hermes 浏览器文档 (Firecrawl 云模式) ](https://hermes-agent.nousresearch.com/docs/user-guide/features/browser#firecrawl-cloud-mode)
* [Firecrawl 搜索](/zh/features/search)
* [Firecrawl 抓取](/zh/features/scrape)
* [Nous Research 模型快速入门](/zh/quickstarts/nous-research) (通过 Hermes 模型调用 API 工具)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.