Web Tools

OpenClaw 有两个轻巧的网页小工具。一个是 web_search，它可以用不同的“搜索服务商”帮你上网搜索。另一个是 web_fetch，它可以去拿一个网页地址里的内容，然后把复杂的网页变成容易读的文字。它们俩都不会像真正的浏览器那样打开网页，所以如果网站需要登录或者有很多动画效果，你需要用另一个叫“浏览器工具”的帮手。

它们是怎么工作的？ web_search 会打电话给你选好的搜索服务商，然后把找到的结果带回来。为了不总是问同样的问题，它会记住你15分钟内问过的问题（这个时间可以改）。web_fetch 会直接去敲网页的门（用 HTTP GET），然后把网页里能读的文字拿出来。它看不懂网页里的动画脚本（JavaScript）。web_fetch 是默认就打开帮你干活的，除非你特意关掉它。

选哪个搜索服务商？ 就像选不同的图书馆一样，每个服务商都有自己的特点。你需要为它们准备一把“钥匙”（API Key）才能用。

• Perplexity Search API：找得快，结果整齐，还能按网站、语言、地区和新旧来筛选。钥匙叫 PERPLEXITY_API_KEY。
• Brave Search API：也很快，结果整齐，但能筛选的条件少一些。钥匙叫 BRAVE_API_KEY。
• Gemini：会用 Google 搜索来帮忙，答案是由 AI 总结好的。需要 GEMINI_API_KEY 这把钥匙。
• Grok：会用 xAI 公司的技术来搜索。需要 XAI_API_KEY 这把钥匙。
• Kimi：会用 Moonshot 公司的技术来搜索。需要 KIMI_API_KEY 或 MOONSHOT_API_KEY 这把钥匙。

如果你没有告诉 OpenClaw 用哪个服务商，它会自己看看你有哪些钥匙，然后按这个顺序选：Brave -> Gemini -> Kimi -> Perplexity -> Grok。如果你一把钥匙都没有，它会试着用 Brave，但会提醒你“需要一把钥匙哦！”

怎么准备钥匙（设置搜索）？ 最简单的办法是告诉 OpenClaw 帮你存好钥匙。在电脑的命令行里输入 openclaw configure --section web，然后按照提示做。你也可以选择自己保管钥匙，把它放在一个叫“环境变量”的秘密地方。

1. 准备 Perplexity 的钥匙：先去 perplexity.ai 的网站注册，在设置里找到 API 部分，生成一把钥匙。然后运行上面的命令，或者把钥匙放到叫 PERPLEXITY_API_KEY 的环境变量里。
2. 准备 Brave 的钥匙：先去 brave.com 的搜索 API 页面注册，在控制台里选 Data for Search 这个计划（不要选“Data for AI”），生成一把钥匙。然后运行上面的命令，或者把钥匙放到叫 BRAVE_API_KEY 的环境变量里。

怎么使用 web_search 工具？ 首先，要确保 tools.web.search.enabled 没有被关掉（默认是开的）。然后，你需要为你选的服务商准备好对应的钥匙。你可以告诉 web_search 很多细节，帮它找得更准：

• query：你想搜索什么，这个必须告诉它。
• count：想要几个结果（1到10个，默认5个）。
• country：在哪个国家找（用两个字母的代码，比如“US”是美国，“DE”是德国）。
• language：用哪种语言找（比如“en”是英语，“de”是德语）。
• freshness：要找多久以内的信息（可以是 day今天, week这周, month这个月, year今年）。
• date_after 和 date_before：找一个时间范围里的信息（格式是“年-月-日”）。
• domain_filter：只去（或不去）哪些网站找（这个只有 Perplexity 能用）。
• max_tokens 和 max_tokens_per_page：让它从网页里拿多少文字内容（这个也只有 Perplexity 能用）。

怎么使用 web_fetch 工具？ 它默认就是开着的。你只需要给它一个网页地址 (url)，它就会去把内容拿回来，变成容易读的文字 (markdown 或 text 格式)。如果网页太复杂，它还可以请另一个叫 Firecrawl 的厉害帮手（需要 FIRECRAWL_API_KEY 钥匙）。你要小心的是：

• 地址必须是 http 或 https 开头的。
• 它会检查网页会不会把它引到别的不安全的地方（用 maxRedirects 控制最多跟几次）。
• 太长的网页内容会被剪短（用 maxChars 控制长度）。
• 有些特别复杂的网站，可能还是需要请“浏览器工具”来帮忙。