# OpenClaw：通过 MCP 添加带网页正文的网页搜索

> 通过 MCP 把 LLMWebSearch 添加到 OpenClaw：openclaw mcp add、doctor --probe，以及 search_web 如何与 16 个内置 web_search 提供方并存。无需 KYC。

- URL: https://llmwebsearch.com/zh/docs/openclaw/
- 最后更新: 2026-10-22
- 发布者: LLMWebSearch (https://llmwebsearch.com)

OpenClaw 已经会从自己的列表里挑选 `web_search` 提供方。注册我们的 MCP server 会新增第二个搜索工具 `search_web`，其结果已附带读取好的顶部页面，另有 `read_urls` 用于处理 agent 已有的链接。

**快速回答 — 如何为 OpenClaw 添加带网页正文的网页搜索 API？**

从我们的 MCP 页面保存 **LLMWebSearch** MCP server，用 `openclaw mcp add llmwebsearch --command … --arg … --env LLMWEBSEARCH_API_KEY=…` 注册，然后用 `openclaw mcp doctor --probe` 检查。agent 会获得 `search_web`，其结果包含前 3 个页面的 Markdown，与 OpenClaw 内置的 `web_search` 并存。每次查询花费 1 积分，截至 2026 年 10 月低至 US$1.20/千次搜索。无需 KYC。

## OpenClaw 搜索，记录于 2026 年 10 月 22 日

| 属性 | 值 |
| --- | --- |
| 内置 web_search 提供方 | 16 个，包括 Brave Search、DeepSeek、DuckDuckGo、Exa、Firecrawl、Gemini、Parallel、Perplexity、SearXNG 和 Tavily |
| 自动选择 | 按固定顺序选第一个就绪的、有 API 支持的提供方，顺序以 Brave 开头 |
| 无需密钥的提供方 | 从不自动选择；由你自行选择 |
| 我们的工具（MCP） | `search_web` 和 `read_urls`，来自本地 Python 服务器 |
| 我们的费用 | 1 积分支付一次查询：最多 20 条排名结果，其中前 3 条的页面会被读取并以 Markdown 返回。读取 4 到 10 个页面为 2 积分。以错误结束的调用不收费 |
| 我们的网页读取器 | `LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/)`，遵守 robots.txt |

## OpenClaw 已有 web_search，为什么还要加我们的搜索？

为了一次调用就拿到结果和网页正文。OpenClaw 的 web tools 页面列出了 16 个用于 `web_search` 的内置提供方，在未设置时按固定的自动检测顺序选择。我们的工具不会取代这一选择；它新增了模型可以主动调用的第二个选项。

`search_web` 返回带编号的来源，前几个页面已作为 Markdown 读取好，因此 agent 无需为每个链接单独抓取就能作答并引用。`read_urls` 通过同一个读取器读取 agent 在其他地方找到的最多 20 个链接。

## 如何注册 MCP server？

先按 [MCP 页面](https://llmwebsearch.com/zh/docs/mcp/) 搭好 Python 服务器：一个文件，加虚拟环境里的 `mcp` 和 `httpx` 包。然后用 `openclaw mcp add` 在 OpenClaw 中保存它。OpenClaw 的 registry 文档介绍了 stdio 参数 `--command`、`--arg`、`--env` 和 `--cwd`，并要求在已保存的服务器变更期间停止本地 Gateway。

接下来运行 `openclaw mcp doctor --probe`。不带 `--probe` 时，doctor 只检查已保存的设置；带上它，还会验证服务器能否连接。

*注册并检查服务器*

```bash
openclaw mcp add llmwebsearch \
  --command /home/you/llmwebsearch/.venv/bin/python \
  --arg /home/you/llmwebsearch/llmwebsearch_mcp.py \
  --env LLMWEBSEARCH_API_KEY=your-key

openclaw mcp doctor llmwebsearch --probe
```

## agent 能看到 search_web 吗？

在通常的 profile 下可以。OpenClaw 的 registry 文档称，已配置的 MCP 工具会出现在 `coding` 和 `messaging` 工具 profile 中。`minimal` profile 会隐藏它们，`tools.deny: ["bundle-mcp"]` 会关闭它们，所以如果工具不见了，请检查这两项设置。

工具的 docstring 会告诉模型它返回什么。如果希望它被优先使用，就在 agent 的指令里加一行，例如“需要引用页面时使用 search_web”。

## LLMWebSearch 能否被选作 web_search provider？

目前不能。OpenClaw 的文档说明，provider 设置只接受由内置插件和已安装插件的 manifest 声明的 provider。我们不发布 OpenClaw 插件，所以我们的搜索以带各自名称的 MCP 工具形式提供。

实际上这对 agent 影响不大：它调用 `search_web` 的方式与调用 `web_search` 一样。这也让两者在 OpenClaw 的日志和你的使用记录中容易区分。

## 我们的 reader 如何处理结果中的网站？

与每次调用时一样。我们的读取器遵守 robots.txt：它会以 LLMWebSearch 表明身份，遵守网站为它或为所有机器人写下的规则，并排除任何它无权读取的页面内容。在 robots.txt 中设置 Content-Signal: ai-input=no 的网站，其页面内容不会出现在你的结果中。当网站拒绝我们的读取器时，结果会不带内容返回，并附上该网站的状态：我们绝不破解 CAPTCHA、不登录账户，也不绕过封锁或付费墙。

因此，登录后才能访问的页面返回时没有内容。对于你已登录的网站，应使用 OpenClaw 自带的浏览器工具，以你的会话运行。

## 通过 OpenClaw 搜索要花多少钱？

每次读取最多 3 个页面的 `search_web` 调用消耗 1 个积分，失败的调用不收费。读取你已持有 URL 的页面：每开始一组 3 个返回内容的页面计 1 积分，每次调用最多 20 个 URL；被拒绝或失败的 URL 不计入。一个每天在其各聊天渠道中搜索 25 次的助手每月约用 750 积分，因此 5,000 次搜索（US$9.25）可用六个多月。查询积分永不过期：这个月没用完的，明年还在。

给 OpenClaw 单独的 API 密钥，这样它的用量就能与其他项目分开显示。

## OpenClaw：常见问题

### 我应该关掉 OpenClaw 自带的 web_search 吗？

不必。两者可以同时开启。只有当你希望所有搜索都走同一个 provider、共用一份账单和一份日志时，才需要关闭内置的那个。

### 它能和沙箱化的 OpenClaw 一起用吗？

MCP server 是一个本地进程，通过 HTTPS 调用 `https://llmwebsearch.com/api/v1`。你的沙箱必须允许它启动并访问该地址。

### 我能从 Control UI 管理这个 server 吗？

OpenClaw 将保存的 MCP server 存放在配置中的 `mcp.servers` 下。它的文档指出，受支持的实时 MCP 设置可在 Control UI 中操作，并说明从命令行更改已保存的 server 需要先停止本地 Gateway。

## 来源

1. [网页工具](https://docs.openclaw.ai/tools/web) — OpenClaw docs (read 2026-10-22)
2. [管理已保存的 MCP server](https://docs.openclaw.ai/cli/mcp/registry) — OpenClaw docs (read 2026-10-22)

---

LLMWebSearch: LLMWebSearch 是一款面向 AI 智能体的网页搜索 API，返回排序后的搜索结果，并附带热门页面的 Markdown 格式内容，采用加密货币支付，无需上传证件。预付费积分低至 US$1.20/千次搜索，永不过期。无 KYC——无需证件、无需自拍、无需提交任何文件。加密货币支付。