# OpenClaw：通过 MCP 添加网页阅读器，与 web_fetch 并列

> 通过 MCP 向 OpenClaw 添加网页阅读器：openclaw mcp add、doctor --probe，以及 read_url 如何补充内置的 web_fetch。无需 KYC，使用加密货币支付。

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

OpenClaw 已经有一个用于轻量页面的 `web_fetch` 工具。添加我们的 MCP server 为 agent 提供了第二个阅读器 `read_url`，用于 JavaScript 页面、PDF 和更长的文档。设置只需一条命令。

**快速回答 — 如何向 OpenClaw 添加网页阅读器 API？**

保存 **WebReaderAPI** MCP server，然后用 `openclaw mcp add webreaderapi --command … --arg … --env WEBREADER_API_KEY=…` 注册它，并用 `openclaw mcp doctor --probe` 检查。agent 会得到一个 `read_url` 工具，与内置的 `web_fetch` 并列，能够渲染 JavaScript 并读取 PDF。页面自 2026 年 10 月起每个消耗 1 积分，价格从 US$0.07/千页 起。无需 KYC；使用加密货币支付。

## OpenClaw 的 web_fetch 与 read_url 并排对比

| 属性 | 值 |
| --- | --- |
| web_fetch（内置） | 本地运行，使用 Readability 提取正文，返回 Markdown 或文本 |
| web_fetch 限制 | 不执行 JavaScript；默认 `maxChars`，上限为 20,000 个字符（OpenClaw 文档） |
| read_url（我们的 MCP 工具） | 在需要时渲染 JavaScript，支持最多 100 页的 PDF，最多 500,000 个字符 |
| read_url 成本 | 1 积分 = 读取 1 个页面且无需浏览器；当页面需要浏览器渲染 JavaScript 时为 2 积分。失败的请求，或被网站 robots.txt 拒绝的请求，不扣费 |
| 我们的爬虫 | `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`，遵守 robots.txt |
| 工具配置 | MCP 工具会出现在 `coding` 和 `messaging` 配置中，不会出现在 `minimal` 中 |

## OpenClaw 已经有 web_fetch，为什么还要加一个 reader？

因为它们覆盖的是不同的页面。OpenClaw 的文档说 `web_fetch` 始终在本地运行，使用 Readability 做正文提取，并且不执行 JavaScript；对于 JavaScript 较重或需要登录的网站，文档指向它的 Web Browser 工具。它的 `maxChars` 设置默认是 20,000 个字符，并以该值为上限。

轻量、简单的页面继续用 `web_fetch`。对于用 JavaScript 构建内容的页面、PDF，以及想要超过 20,000 个字符的长文档，再加上 `read_url`。OpenClaw 的文档还指出，官方 Firecrawl 插件目前是 `web_fetch` 唯一可以回退到的内置提供商。

## 如何在 OpenClaw 中注册 MCP server？

先从 [MCP 页面](https://webreaderapi.com/zh/docs/mcp/) 搭好 Python server：一个文件，加上 `mcp` 和 `httpx` 两个包。然后用 `openclaw mcp add` 把它保存到 OpenClaw 中。OpenClaw 的注册文档介绍了 stdio 参数 `--command`、`--arg`、`--env` 和 `--cwd`，并把保存的定义存放在其配置中的 `mcp.servers` 下。

之后运行 `openclaw mcp doctor --probe`。不带 `--probe` 时，doctor 只检查保存的配置；带上它，还会确认已启用的 server 能够连接。

*注册并检查 server*

```bash
openclaw mcp add webreaderapi \
  --command /home/you/webreader/.venv/bin/python \
  --arg /home/you/webreader/webreader_mcp.py \
  --env WEBREADER_API_KEY=your-key

openclaw mcp doctor webreaderapi --probe
```

## agent 能看到 read_url 吗？

在常用的配置中，可以。OpenClaw 的注册文档说，内嵌的 OpenClaw 会在 `coding` 和 `messaging` 配置中公开已配置的 MCP 工具。`minimal` 配置会隐藏它们，`tools.deny: ["bundle-mcp"]` 会将其关闭，所以如果工具没有出现，请检查这两个设置。

工具的描述会告诉模型何时优先使用它：需要 JavaScript 的页面、PDF 和长时间阅读。其余情况模型仍可使用 `web_fetch`。

## read_url 会如何对待它读取的网站？

和我们 API 的每一次调用一样。我们遵守 robots.txt：我们的爬虫以 WebReaderAPI 标识自身，遵循专为其或为所有爬虫编写的规则，不读取网站禁止的页面。被拒绝的页面不扣费。如果网站在其 robots.txt 中声明 Content-Signal: ai-input=no，我们不会为你读取其页面。如果网站拒绝我们的请求，我们会返回其答复：我们从不破解 CAPTCHA、不登录账户，也不试图绕过封锁或付费墙。

因此，需要登录的页面不在 `read_url` 的范围内。对于你已登录的网站，用 OpenClaw 自带的浏览器工具、以你的会话运行，才是合适的工具。

## 通过 OpenClaw 读取页面要花多少钱？

每返回一个有内容的页面消耗 1 个积分，需要浏览器时消耗 2 个积分，被拒绝和出错不收费。一个在其各个聊天渠道中每天读取 30 个页面的助手，每月大约用 900 个积分：10,000 个网页（US$3.75）差不多能用将近一年。预付费积分永不过期：未使用的页面数会一直保留在你的账户中，直到你使用。

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

## OpenClaw：常见问题

### WebReaderAPI 是 OpenClaw 内置的提供商吗？

不是。它通过 MCP server 连接，OpenClaw 无需任何插件代码即可支持。该 MCP server 就是我们 [MCP 页面](https://webreaderapi.com/zh/docs/mcp/) 上那个简短的 Python 文件。

### 我应该禁用 web_fetch 吗？

没必要。两个工具都可以保持开启；描述会告诉模型哪一个更合适。只有当你希望所有读取都经过同一个地方以便记录日志时，才禁用 `web_fetch`。

### 我能从 OpenClaw 的网页界面管理该 server 吗？

OpenClaw 的文档说明 MCP 设置位于其 Control UI 中，它编辑的是与命令行相同的已保存定义。用你更喜欢的那个即可。

### 它在沙箱化的 OpenClaw 环境中能用吗？

MCP server 是一个本地进程，需要访问互联网才能连接到 `https://webreaderapi.com/api/v1/read`。请检查你的沙箱是否允许该进程启动并发出那次 HTTPS 调用。

## 来源

1. [网页工具](https://docs.openclaw.ai/tools/web) — OpenClaw docs (read 2026-10-22)
2. [Web Fetch](https://docs.openclaw.ai/tools/web-fetch) — OpenClaw docs (read 2026-10-22)
3. [管理已保存的 MCP server](https://docs.openclaw.ai/cli/mcp/registry) — OpenClaw docs (read 2026-10-22)
4. [Control UI 中的 MCP](https://docs.openclaw.ai/cli/mcp/control-ui) — OpenClaw docs (read 2026-10-22)

---

WebReaderAPI: WebReaderAPI 是一款面向 AI agents 的网页读取 API，可将任何公开网页转换为干净的 Markdown，用加密货币支付，无需上传身份证件。预付费积分低至 US$0.07/千页，永不过期，且遵守 robots.txt。无需 KYC — 无身份证、无自拍、无证件。加密货币支付。