Search1API文档

OpenClaw

通过 ClawHub 上的原生 openclaw-search1api 插件,为 OpenClaw 提供实时网页搜索、智能搜索、新闻、页面读取、站点地图发现和热门话题。

openclaw-search1api 是一个原生 OpenClaw 插件,通过 Search1API 为 Gateway 提供实时网络访问——网页搜索、智能搜索、新闻搜索、可读页面获取、站点地图发现和热门话题。

与 MCP 桥接不同,该插件将这些能力注册为一等 OpenClaw 工具。

安装

从 ClawHub 安装:

openclaw plugins install clawhub:@fatwang2/openclaw-search1api

安装后重启或重新加载 OpenClaw Gateway,然后验证运行时:

openclaw plugins inspect search1api --runtime --json

认证

使用以下任一方式:

  1. 在 OpenClaw Gateway 的环境中设置 SEARCH1API_KEY。
  2. 安装 search1api-cli 并运行一次 s1 login;插件会复用同一个 OAuth 会话。
  3. 通过 OpenClaw 的密钥管理功能存储 apiKey。

如果使用环境变量,请在 Search1API 仪表盘中创建密钥。

Agent 能做什么

工具作用
search1api_search实时网页搜索
search1api_ask只需 query 的智能搜索(5 积分,45 秒超时)
search1api_news新闻搜索
search1api_crawl将公开 URL 读取为干净的 Markdown
search1api_sitemap列举网站的 URL
search1api_trendingGitHub 热门仓库或 Hacker News 热门文章

search1api_ask 只接受 query(1-500 个字符)。其响应会保留 query、intent、结果的 source 和 relevance,以及可选的 errors。 参见智能搜索。

积分

搜索和新闻请求每次消耗 1 积分;抓取页面时,每个成功抓取的页面额外消耗 1 积分。智能搜索每次请求消耗 5 积分。新账户无需信用卡即可获得 100 积分。当前费率参见积分与限制。

搜索过滤条件与结果字段

0.2.0 版本支持全部 19 个搜索引擎和全部 6 个 新闻来源,包括 Bing China、Yandex、Grokipedia 和 Reuters。 time_range 支持 day、week、month 和 year;page 支持搜索 分页。这些过滤条件适用于搜索/新闻;智能搜索只接受 query。

引擎特有的结果字段位于可选的 metadata 中:GitHub 搜索提供 metadata.kind、metadata.stars、metadata.language 和 metadata.num_comments; Hacker News 搜索提供 metadata.story_url、metadata.points 和 metadata.num_comments。可选的 published_date 保留在结果顶层。 响应级的 searchParameters 描述实际执行的请求。这些路径 适用于搜索/新闻;热门保持其独立的响应结构。

源码

github.com/superagents-lab/openclaw-search1api

本页内容