跳转到主要内容
OpenClaw 可以通过三种方式使用 Firecrawl：
  • 作为 web_search 提供商
  • 作为显式插件工具：firecrawl_search 和 firecrawl_scrape
  • 作为 web_fetch 的回退提取器
它是一个托管式提取/搜索服务，支持绕过机器人检测和缓存，有助于处理 JS 密集型网站或阻止普通 HTTP 获取的页面。

​
安装插件

安装官方插件，然后重启 Gateway 网关： 
openclaw plugins install @openclaw/firecrawl-plugin
openclaw gateway restart

​
无密钥 web_fetch 和 API 密钥

显式选择的托管 Firecrawl web_fetch 回退支持无 API 密钥的入门访问。在 Gateway 网关环境中添加 FIRECRAWL_API_KEY，或在需要更高额度时配置它。Firecrawl web_search 和 firecrawl_scrape 需要 API 密钥。

​
配置 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 的 web_search 支持 query 和 count。
  • 对于 Firecrawl 专用控制项，例如 sources、categories 或结果抓取，请使用 firecrawl_search。
  • baseUrl 默认使用位于 https://api.firecrawl.dev 的托管 Firecrawl。仅允许对私有/内部端点使用自托管覆盖；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 会在把目标 URL 转发给 Firecrawl 之前，拒绝明显的私有、loopback、metadata 和非 HTTP(S) 目标 URL，与显式 Firecrawl 抓取调用的 web_fetch 目标安全契约一致。
firecrawl_scrape 复用相同的 plugins.entries.firecrawl.config.webFetch.* 设置和环境变量，包括它所需的 API 密钥。

​
自托管 Firecrawl

当你自行运行 Firecrawl 时，设置 plugins.entries.firecrawl.config.webSearch.baseUrl、plugins.entries.firecrawl.config.webFetch.baseUrl 或 FIRECRAWL_BASE_URL。OpenClaw 仅对 loopback、私有网络、.local、.internal 或 .localhost 目标接受 http://。公共自定义主机会被拒绝，以免意外把 Firecrawl API 密钥发送到任意端点。

​
Firecrawl 插件工具

当你想使用 Firecrawl 专用搜索控制项，而不是通用 web_search 时使用它。 参数：
  • query
  • count
  • sources
  • categories
  • scrapeResults
  • timeoutSeconds

​
firecrawl_scrape

对于 JS 密集型或受机器人保护、普通 web_fetch 效果较弱的页面，请使用它。 参数：
  • url
  • extractMode
  • maxChars
  • onlyMainContent
  • maxAgeMs
  • proxy
  • storeInCache
  • timeoutSeconds

​
隐身 / 绕过机器人检测

firecrawl_scrape 和 web_fetch 的 Firecrawl 回退默认使用 proxy: "auto" 加 storeInCache: true，除非调用方覆盖这些参数。firecrawl_search 和 web_search Firecrawl 提供商没有 proxy/storeInCache 控制项；隐身代理模式仅适用于抓取/获取请求。 Firecrawl 的 proxy 模式控制绕过机器人检测（basic、stealth 或 auto）。如果基础尝试失败，auto 会使用隐身代理重试，这可能比仅基础抓取消耗更多额度。

​
web_fetch 如何使用 Firecrawl

web_fetch 提取顺序：
  1. Readability（本地）
  2. 已配置的获取提供商，例如 Firecrawl（当已选择，或从已配置凭据自动检测到时）
  3. 基础 HTML 清理（最后回退）
选择开关是 tools.web.fetch.provider。如果省略它，OpenClaw 会从可用凭据中自动检测第一个就绪的 Web 获取提供商。官方 Firecrawl 插件提供该回退。

​
相关内容