快速回答
如何为 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 页面 搭好 Python 服务器:一个文件,加虚拟环境里的 mcp 和 httpx 包。然后用 openclaw mcp add 在 OpenClaw 中保存它。OpenClaw 的 registry 文档介绍了 stdio 参数 --command、--arg、--env 和 --cwd,并要求在已保存的服务器变更期间停止本地 Gateway。
接下来运行 openclaw mcp doctor --probe。不带 --probe 时,doctor 只检查已保存的设置;带上它,还会验证服务器能否连接。
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 --probeagent 能看到 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。
来源 (2)
- 网页工具 — OpenClaw docs (read 2026-10-22)
- 管理已保存的 MCP server — OpenClaw docs (read 2026-10-22)