快速开始
网页抓取
web_fetch 执行普通的 HTTP GET，并提取可读内容（将 HTML 转换为
Markdown 或文本）。它不会执行 JavaScript。对于高度依赖 JS 的网站或
受登录保护的页面，请改用 Web 浏览器。
快速开始
默认启用，无需配置：
await web_fetch({ url: "https://example.com/article" });工具参数
urlstringrequired要获取的 URL。仅支持 http(s)。
extractMode'markdown' | 'text'default: markdown提取主要内容后的输出格式。
maxCharsnumber将输出截断为指定字符数。上限为 tools.web.fetch.maxCharsCap。
工作原理
获取
使用类似 Chrome 的 User-Agent 和 Accept-Language
标头发送 HTTP GET。阻止私有/内部主机名，并重新检查重定向。
提取
对 HTML 响应运行 Readability（主要内容提取）。
回退（可选）
如果 Readability 失败且有可用的获取提供商，则通过 该提供商重试（例如 Firecrawl 的机器人规避模式）。
缓存
结果会缓存 15 分钟（可配置），以减少对同一 URL 的重复获取。
进度更新
仅当获取操作在五秒后仍处于待处理状态时，web_fetch 才会发出一行公开进度信息：
正在获取页面内容...快速缓存命中和迅速完成的网络响应会在计时器触发前结束，因此 不会显示进度信息。取消调用会清除计时器。该进度信息仅表示渠道 UI 状态， 绝不会包含获取到的页面内容。
配置
{ tools: { web: { fetch: { enabled: true, // 默认值：true provider: "firecrawl", // 可选；省略则自动检测 maxChars: 20000, // 默认输出字符数；受 maxCharsCap 限制 maxCharsCap: 20000, // maxChars 参数的硬性上限 maxResponseBytes: 750000, // 截断前的最大下载大小（32000-10000000） timeoutSeconds: 30, cacheTtlMinutes: 15, maxRedirects: 3, useTrustedEnvProxy: false, // 允许受信任的 HTTP(S) 环境代理解析 DNS readability: true, // 使用 Readability 提取 userAgent: "Mozilla/5.0 ...", // 覆盖 User-Agent ssrfPolicy: { allowRfc2544BenchmarkRange: true, // 为使用 198.18.0.0/15 的受信任虚假 IP 代理选择启用 allowIpv6UniqueLocalRange: true, // 为使用 fc00::/7 的受信任虚假 IP 代理选择启用 }, }, }, },}Firecrawl 回退
如果 Readability 提取失败，web_fetch 可以回退到
Firecrawl，以规避机器人限制并改善提取效果：
{ tools: { web: { fetch: { provider: "firecrawl", // 可选；省略则根据可用凭据自动检测 }, }, }, plugins: { entries: { firecrawl: { enabled: true, config: { webFetch: { // apiKey: "fc-...", // 可选；省略则使用无密钥的入门访问 baseUrl: "https://api.firecrawl.dev", onlyMainContent: true, maxAgeMs: 172800000, // 缓存时长（2 天） timeoutSeconds: 60, }, }, }, }, },}plugins.entries.firecrawl.config.webFetch.apiKey 是可选项，并支持 SecretRef 对象。
旧版 tools.web.fetch.firecrawl.* 配置会通过 openclaw doctor --fix
自动迁移到 plugins.entries.firecrawl.config.webFetch。
当前运行时行为：
tools.web.fetch.provider用于显式选择获取回退提供商。- 如果省略
provider，OpenClaw 会根据已配置的凭据自动检测首个就绪的网页获取 提供商。非沙箱隔离的web_fetch可以使用已安装的插件，只要这些插件声明contracts.webFetchProviders并在运行时注册匹配的提供商。目前官方 Firecrawl 插件提供此回退。 - 沙箱隔离的
web_fetch调用允许使用内置提供商，以及官方 npm 或 ClawHub 来源已经验证的已安装提供商。目前这允许使用官方 Firecrawl 插件；第三方 外部获取插件仍被排除。 - 如果禁用 Readability，
web_fetch会直接跳到选定的提供商回退。如果没有 可用的提供商，则以关闭方式失败。
受信任的环境代理
如果你的部署要求 web_fetch 通过受信任的出站
HTTP(S) 代理，请设置 tools.web.fetch.useTrustedEnvProxy: true。
在此模式下，OpenClaw 仍会在发送请求之前应用基于主机名的 SSRF 检查， 但会让代理解析 DNS，而不是在本地进行 DNS 固定。仅当代理由操作员控制， 并且在 DNS 解析后强制执行出站策略时，才应启用此选项。
限制与安全
maxChars的上限为tools.web.fetch.maxCharsCap（默认值为20000）- 响应正文在解析前受
maxResponseBytes限制（默认值为750000，限制在 32000-10000000 之间）；过大的响应会被截断并显示警告 - 私有/内部主机名会被阻止
tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange和tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange是针对 受信任虚假 IP 代理栈的有限选择启用项；除非你的代理拥有这些合成地址范围 并强制执行自身的目标策略，否则请不要设置它们- 重定向会接受检查，并受
maxRedirects限制（默认值为3） useTrustedEnvProxy是显式选择启用项，仅应为由操作员控制，且在 DNS 解析后仍强制执行出站策略的代理启用web_fetch仅尽力而为——某些网站需要使用 Web 浏览器
工具配置文件
如果你使用工具配置文件或允许列表，请添加 web_fetch 或 group:web：
{ tools: { allow: ["web_fetch"], // 或：allow: ["group:web"]（包括 web_fetch、web_search 和 x_search） },}