English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

内置工具

Firecrawl

OpenClaw 可以通过三种方式使用 Firecrawl：

  • 作为 web_search 提供商
  • 作为显式插件工具：firecrawl_search 和 firecrawl_scrape
  • 作为 web_fetch 的后备提取器

它是一项托管的提取/搜索服务，支持机器人规避和缓存， 有助于处理 JS 较重的网站，或会阻止普通 HTTP 抓取的页面。

获取 API key

  1. 创建 Firecrawl 账户并生成 API key。
  2. 将其存储在配置中，或在 Gateway 网关环境中设置 FIRECRAWL_API_KEY。

配置 Firecrawl 搜索

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

注意事项：

  • 在新手引导或 openclaw configure --section web 中选择 Firecrawl，会自动启用内置 Firecrawl 插件。
  • 使用 Firecrawl 的 web_search 支持 query 和 count。
  • 对于 Firecrawl 专用控制项，例如 sources、categories 或结果抓取，请使用 firecrawl_search。
  • baseUrl 默认指向托管的 Firecrawl：https://api.firecrawl.dev。仅允许为私有/内部端点使用自托管覆盖；HTTP 仅对这些私有目标可接受。
  • FIRECRAWL_BASE_URL 是 Firecrawl 搜索和抓取基础 URL 的共享环境变量后备项。

配置 Firecrawl 抓取 + web_fetch 后备

{
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webFetch: {
            apiKey: "FIRECRAWL_API_KEY_HERE",
            baseUrl: "https://api.firecrawl.dev",
            onlyMainContent: true,
            maxAgeMs: 172800000,
            timeoutSeconds: 60,
          },
        },
      },
    },
  },
}

注意事项：

  • Firecrawl 后备尝试仅在有 API key 可用时运行（plugins.entries.firecrawl.config.webFetch.apiKey 或 FIRECRAWL_API_KEY）。
  • maxAgeMs 控制缓存结果可以多旧（毫秒）。默认值为 2 天。
  • 旧版 tools.web.fetch.firecrawl.* 配置会由 openclaw doctor --fix 自动迁移。
  • Firecrawl 抓取/基础 URL 覆盖遵循与搜索相同的托管/私有规则：公共托管流量使用 https://api.firecrawl.dev；自托管覆盖必须解析到私有/内部端点。
  • firecrawl_scrape 会先拒绝明显的私有、loopback、元数据和非 HTTP(S) 目标 URL，然后再将它们转发给 Firecrawl，这与显式 Firecrawl 抓取调用的 web_fetch 目标安全合同保持一致。

firecrawl_scrape 复用相同的 plugins.entries.firecrawl.config.webFetch.* 设置和环境变量。

自托管 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 key 意外发送到任意端点。

Firecrawl 插件工具

当你想使用 Firecrawl 专用搜索控制项，而不是通用 web_search 时，请使用它。

核心参数：

  • query
  • count
  • sources
  • categories
  • scrapeResults
  • timeoutSeconds

firecrawl_scrape

对于 JS 较重或受机器人防护的页面，如果普通 web_fetch 效果较弱，请使用它。

核心参数：

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

隐身 / 机器人规避

Firecrawl 为机器人规避暴露了一个 proxy mode 参数（basic、stealth 或 auto）。 OpenClaw 始终对 Firecrawl 请求使用 proxy: "auto" 加 storeInCache: true。 如果省略 proxy，Firecrawl 默认使用 auto。如果 basic 尝试失败，auto 会使用隐身代理重试，这可能比仅 basic 抓取消耗更多 credits。

web_fetch 如何使用 Firecrawl

web_fetch 提取顺序：

  1. Readability（本地）
  2. Firecrawl（如果被选中，或被自动检测为当前 Web 抓取后备）
  3. 基础 HTML 清理（最后后备）

选择旋钮是 tools.web.fetch.provider。如果省略它，OpenClaw 会从可用凭证中自动检测第一个就绪的 Web 抓取提供商。 目前内置提供商是 Firecrawl。

相关