OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Firecrawl

这页说明书在讲一个叫 Firecrawl 的“网页小帮手”。当你让 OpenClaw 去网上找东西,但有些网页像穿了“隐身衣”一样很难直接拿到时,这个小帮手就会跳出来帮忙。它特别会对付那些用很多动画和代码的复杂网站。

我们会告诉你,怎么拿到 Firecrawl 的“魔法钥匙”(API Key),怎么把它装到 OpenClaw 里,还有它工作时的一些小秘密。如果你发现 OpenClaw 有时抓不到网页内容,就可以来看看这页。

五岁小孩版解释

Firecrawl 就像一个很会找东西的“网页小侦探”。有些网站为了保护自己,会设置一些“小机关”来挡住普通的抓取工具。Firecrawl 侦探有办法绕过这些机关,还能把找到的东西暂时“记在小本子”(缓存)上,这样下次找同样的东西就更快啦。

第一步:拿到侦探的“魔法钥匙”

要让 Firecrawl 侦探帮你工作,你需要先有一把“魔法钥匙”,它的名字叫 API Key

  1. 做什么:先去 Firecrawl 的网站注册一个账号,就像注册一个游戏账号一样。
  2. 怎么做:注册好后,你就能在里面生成一把属于你自己的 API Key 了。拿到钥匙后,你要把它保管好,可以放在 OpenClaw 的配置文件里,或者放在一个叫 FIRECRAWL_API_KEY 的环境变量里。

第二步:把钥匙交给 OpenClaw

现在,我们要告诉 OpenClaw 怎么使用这位侦探和你的钥匙。你需要修改一下 OpenClaw 的配置文件。

  1. 做什么:在配置文件里找到 tools -> web -> fetch 这部分。
  2. 怎么做:在里面加上关于 Firecrawl 的设置,就像下面这样(记得把 YOUR_API_KEY_HERE 换成你真正的钥匙): apiKey: "YOUR_API_KEY_HERE" baseUrl: "https://api.firecrawl.dev" onlyMainContent: true maxAgeMs: 172800000 timeoutSeconds: 60

这里要小心apiKey 那里一定要填对,不然侦探就不认识你啦!

小提示

  • 只要你放好了钥匙,Firecrawl 侦探就会自动开始工作(enabled 默认是 true)。
  • maxAgeMs 是侦探“小本子”的记忆时间。默认是 172800000 毫秒,也就是 2 天。意思是,如果侦探在 2 天内找过同一个网页,它会直接看小本子,不用再跑一趟。

第三步:侦探的“隐身”技巧

Firecrawl 侦探有三种“隐身”模式去访问网站:basic(普通)、stealth(超级隐身)和 auto(自动选择)。OpenClaw 总是会用 auto 模式,并且会把结果记在小本子上。

  • auto 模式很聪明:它会先用普通方式试试,如果被网站挡住了,它就会自动切换到“超级隐身”模式再试一次。不过要注意,用“超级隐身”模式可能会多用一点点“侦探积分”(credits)。

第四步:侦探什么时候出动?

OpenClaw 自己去网上拿内容(web_fetch)时,会按顺序找三个帮手:

  1. 先让一个叫 Readability 的本地小帮手试试。
  2. 如果第一个小帮手搞不定,就请 Firecrawl 侦探出马。
  3. 如果连侦探也拿不到,就用最后一个办法:Basic HTML cleanup,对网页做最简单的清理。

所以,Firecrawl 是第二个出场的重要帮手!如果你想了解 OpenClaw 所有关于上网找东西的工具,可以去看 Web tools 那页说明书。