# OpenClaw

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

Canonical URL: https://s1.dev/zh/docs/integrations/openclaw

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

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

## 安装

从 ClawHub 安装：

```bash
openclaw plugins install clawhub:@fatwang2/openclaw-search1api
```

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

```bash
openclaw plugins inspect search1api --runtime --json
```

## 认证

使用以下任一方式：

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

如果使用环境变量，请在 [Search1API 仪表盘](https://app.s1.dev)中创建密钥。

## Agent 能做什么

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

`search1api_ask` 只接受 `query`（1-500 个字符）。其响应会保留
`query`、`intent`、结果的 `source` 和 `relevance`，以及可选的 `errors`。
参见[智能搜索](https://s1.dev/zh/docs/basic/ask)。

## 积分

搜索和新闻请求每次消耗 1 积分；抓取页面时，每个成功抓取的页面额外消耗 1 积分。智能搜索每次请求消耗 5 积分。新账户无需信用卡即可获得 100 积分。当前费率参见[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)。

## 搜索过滤条件与结果字段

**0.2.0** 版本支持全部 19 个[搜索引擎](https://s1.dev/zh/docs/basic/search)和全部 6 个
[新闻来源](https://s1.dev/zh/docs/basic/news)，包括 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` 描述实际执行的请求。这些路径
适用于搜索/新闻；[热门](https://s1.dev/zh/docs/advanced/trending)保持其独立的响应结构。

## 源码

[github.com/superagents-lab/openclaw-search1api](https://github.com/superagents-lab/openclaw-search1api)