Firecrawl

• 作为 web_search 提供方
• 作为显式插件工具：firecrawl_search 和 firecrawl_scrape
• 作为 web_fetch 的回退提取器

​

安装插件

openclaw plugins install @openclaw/firecrawl-plugin
openclaw gateway restart

​

无密钥访问和 API 密钥

• Firecrawl Search (firecrawl) — 使用托管的 /v2/search API 和你的 密钥；当检测到存在密钥时会自动选中。
• Firecrawl Search (Free) (firecrawl-free) — 使用托管的无密钥入门 套餐，不需要 API 密钥。它仅限手动选择，且绝不会自动选中，因为 选择它会将你的搜索查询发送到 Firecrawl 的免费套餐。

​

配置 Firecrawl 搜索

{
  tools: {
    web: {
      search: {
        provider: "firecrawl",
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "FIRECRAWL_API_KEY_HERE",
            baseUrl: "https://api.firecrawl.dev",
          },
        },
      },
    },
  },
}

• 在引导流程中选择 Firecrawl，或使用 openclaw configure --section web，会自动启用已安装的 Firecrawl 插件。
• 在引导流程中选择 Firecrawl Search (Free)（或设置 provider: "firecrawl-free"），即可无密钥运行，无需 API key。带密钥的 Firecrawl Search 提供程序会发送 plugins.entries.firecrawl.config.webSearch.apiKey 或 FIRECRAWL_API_KEY。
• 使用 Firecrawl 的 web_search 支持 query 和 count。
• 对于 Firecrawl 特有的控制项，例如 sources、categories 或结果抓取，请使用 firecrawl_search。
• baseUrl 默认指向托管的 Firecrawl：https://api.firecrawl.dev。仅允许对私有/内部端点使用自托管覆盖；只有这些私有目标才接受 HTTP。
• FIRECRAWL_BASE_URL 是 Firecrawl 搜索和抓取基础 URL 的共享环境变量回退值。
• Firecrawl 搜索请求默认超时时间为 30 秒；firecrawl_search 的 timeoutSeconds 参数可按单次调用覆盖它。

​

配置 Firecrawl web_fetch 回退

{
  tools: {
    web: {
      fetch: {
        provider: "firecrawl", // 显式选择会启用无密钥回退
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webFetch: {
            baseUrl: "https://api.firecrawl.dev",
            onlyMainContent: true,
            maxAgeMs: 172800000,
            timeoutSeconds: 60,
          },
        },
      },
    },
  },
}

• 显式选择的 Firecrawl web_fetch 回退在没有 API 密钥的情况下也可工作。配置后，OpenClaw 会发送 plugins.entries.firecrawl.config.webFetch.apiKey 或 FIRECRAWL_API_KEY，以获得更高的额度。
• 在引导设置期间选择 Firecrawl，或运行 openclaw configure --section web，会启用该插件并为 web_fetch 选择 Firecrawl，除非已经配置了其他抓取提供方。
• firecrawl_scrape 需要 API 密钥。
• maxAgeMs 控制缓存结果可以有多旧（毫秒）。默认值为 172,800,000 毫秒（2 天）。
• onlyMainContent 默认为 true；timeoutSeconds 默认为 60。
• 旧版的 tools.web.fetch.firecrawl.* 和 tools.web.search.firecrawl.* 配置会被 openclaw doctor --fix 自动迁移。
• Firecrawl 的抓取/基础 URL 覆盖遵循与搜索相同的托管/自托管规则：公共托管流量使用 https://api.firecrawl.dev；自托管覆盖必须解析到私有/内部端点。
• 在将 firecrawl_scrape 转发给 Firecrawl 之前，它会拒绝明显的私有、回环、元数据以及非 HTTP(S) 目标 URL，这与显式 Firecrawl 抓取调用的 web_fetch 目标安全契约一致。

​

自托管 Firecrawl

​

Firecrawl 插件工具

​

firecrawl_search

• query
• count (1-100)
• sources
• categories
• includeDomains / excludeDomains（仅限主机名；二者互斥）
• tbs（时间筛选，例如 qdr:d、qdr:w、sbd:1）
• location 和 country（地理定向）
• scrapeResults
• timeoutSeconds

​

firecrawl_scrape

• url
• extractMode
• maxChars
• onlyMainContent
• maxAgeMs
• proxy
• storeInCache
• timeoutSeconds

​

隐身 / 反爬虫绕过

​

web_fetch 如何使用 Firecrawl

1. Readability（本地）
2. 已配置的抓取提供方，例如 Firecrawl（在选择时，或从已配置的凭据自动检测到时）
3. 基础 HTML 清理（最后的回退方案）

​

相关内容

• Web Search 概览 — 所有提供方和自动检测
• Web Fetch — 带有 Firecrawl 回退的 web_fetch 工具
• Tavily — 搜索 + 提取工具