快速回答
如何向 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 页面 搭好 Python server:一个文件,加上 mcp 和 httpx 两个包。然后用 openclaw mcp add 把它保存到 OpenClaw 中。OpenClaw 的注册文档介绍了 stdio 参数 --command、--arg、--env 和 --cwd,并把保存的定义存放在其配置中的 mcp.servers 下。
之后运行 openclaw mcp doctor --probe。不带 --probe 时,doctor 只检查保存的配置;带上它,还会确认已启用的 server 能够连接。
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 --probeagent 能看到 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 页面 上那个简短的 Python 文件。
我应该禁用 web_fetch 吗?
没必要。两个工具都可以保持开启;描述会告诉模型哪一个更合适。只有当你希望所有读取都经过同一个地方以便记录日志时,才禁用 web_fetch。
我能从 OpenClaw 的网页界面管理该 server 吗?
OpenClaw 的文档说明 MCP 设置位于其 Control UI 中,它编辑的是与命令行相同的已保存定义。用你更喜欢的那个即可。
它在沙箱化的 OpenClaw 环境中能用吗?
MCP server 是一个本地进程,需要访问互联网才能连接到 https://webreaderapi.com/api/v1/read。请检查你的沙箱是否允许该进程启动并发出那次 HTTPS 调用。
来源 (4)
- 网页工具 — OpenClaw docs (read 2026-10-22)
- Web Fetch — OpenClaw docs (read 2026-10-22)
- 管理已保存的 MCP server — OpenClaw docs (read 2026-10-22)
- Control UI 中的 MCP — OpenClaw docs (read 2026-10-22)