前置基础：两种调用方式

1. 聊天框斜杠指令（最常用，对话内直接执行）
   • 通用格式：/工具名 参数=值
   • browser 专用：/skill browser-use xxx
2. 终端 CLI 命令（脚本 / 批量自动化）

   bash

   运行

   openclaw web_search xxx
   openclaw web_fetch xxx
   openclaw browser xxx
   

一、web_search 全网搜索工具（Brave / Tavily）

1. 核心作用

输入文字关键词，调用第三方搜索引擎 API，返回多条网页标题、摘要、URL；不能传网址，仅做检索找链接，不读取全文。

2. 前置配置（必须做，否则报错）

配置 API 密钥

bash

运行

# 进入web配置面板，填入Tavily/Brave密钥
openclaw configure --section web
# 重启网关生效
openclaw gateway restart

• provider=tavily：国内更稳定、中文友好，AI 专用检索
• provider=brave：海外通用隐私搜索引擎，国内访问不稳定

3. 常用参数

表格

参数	说明
query	必选，搜索关键词
provider	搜索引擎：tavily /brave
count	返回结果条数，默认 5，最大 10
freshness	时效：day (当天)/week (一周)/month (一月)
domain_filter	限定域名，如[".gov", ".edu"]

4. 聊天框调用示例

示例 1：基础中文检索（Tavily 推荐）

plaintext

/web_search query=2026深紫外激光器行业现状 provider=tavily freshness=week count=6

执行结果：返回 6 条近期资讯，每条包含标题、简介、网页链接。

示例 2：限定政府官网、一周新闻（Brave）

plaintext

/web_search query=国内半导体扶持政策 provider=brave freshness=week domain_filter=[".gov.cn"]

5. CLI 终端命令示例

bash

运行

openclaw web_search --query "南京7月高温预报" --provider tavily --freshness day

6. 适用 / 不适用场景

✅ 适合：查未知资讯、行业报告、实时新闻、不知道网页地址 ❌ 不适合：打开指定网址、抓取页面内容、网页点击交互

二、web_fetch 轻量静态网页抓取

1. 核心作用

输入单个 URL，纯 HTTP 请求下载网页静态 HTML，清洗广告后输出 Markdown 正文；无浏览器内核、不执行 JS；无需密钥，开箱即用。

2. 常用参数

表格

参数	说明
url	必选，完整网页地址
extractMode	输出格式：markdown /text
maxChars	最大提取文字长度，防止超长页面

3. 聊天框调用示例

示例 1：抓取百度首页静态源码

plaintext

/web_fetch url=https://www.baidu.com extractMode=markdown maxChars=8000

缺陷：百度首页 JS 渲染的搜索弹窗、动态推荐内容无法获取，只有基础 HTML 文字。

示例 2：抓取静态技术文档

plaintext

/web_fetch url=https://docs.openclaw.ai extractMode=text

4. CLI 终端命令

bash

运行

openclaw web_fetch --url https://docs.openclaw.ai --extractMode markdown

5. 优缺点与适用场景

✅ 优点：启动快、占用资源极低、无需配置密钥、批量抓取效率高 ❌ 缺点：JS 动态页面、登录站点、商品列表内容空白；易触发网站反爬 403 适用：静态文章、纯 HTML 官网、文档、纯文本资讯

三、browser 完整浏览器自动化工具（唯一能操作百度搜索框）

1. 核心作用

内置 Chromium 完整浏览器内核，100% 渲染 JS、维持 Cookie 登录、支持输入 / 点击 / 翻页 / 截图；可完整操作www.baidu.com网页搜索；默认关闭，需手动开启。

2. 开启浏览器功能

bash

运行

# 开启浏览器总开关
openclaw config set browser.enabled true
# 服务器无显示器开启无头模式（电脑可关闭）
openclaw config set browser.headless true
openclaw gateway restart

3. 常用操作指令

聊天框 /skill 调用（对话自动化）

plaintext

# 1. 打开百度官网
/skill browser-use open https://www.baidu.com

# 2. 在百度搜索框输入关键词
/skill browser-use input 搜索框 2026南京高温天气

# 3. 点击“百度一下”按钮检索
/skill browser-use click 百度一下

# 4. 页面截图
/skill browser-use screenshot

# 5. 获取页面全部文本
/skill browser-use snapshot

# 6. 页面后退
/skill browser-use back

CLI 终端独立命令

bash

运行

# 打开百度
openclaw browser open https://www.baidu.com
# 截图
openclaw browser screenshot
# 查看所有标签页
openclaw browser tabs
# 关闭当前标签
openclaw browser close-tab

4. 完整实战流程：用 browser 实现百度网页搜索

1. 打开百度首页：/skill browser-use open https://www.baidu.com
2. 输入关键词：/skill browser-use input 搜索框 OpenClaw使用教程
3. 点击搜索：/skill browser-use click 百度一下
4. 读取搜索结果全文：/skill browser-use snapshot

5. 适用场景

1. JS 动态网页、SPA 管理系统、电商商品页（web_fetch 抓不全）
2. 需要登录才能查看内容的网站
3. 网页交互：输入、点击、翻页、表单填写
4. 必须使用百度中文本土检索（web_search 不访问百度官网）
5. 网页截图、批量自动化操作

四、三者完整协同实战流程（标准查资料链路）

场景：查询「2026 深紫外激光器行业报告」

步骤 1：web_search 全网检索，获取一批网页链接

plaintext

/web_search query=2026深紫外激光器行业报告 provider=tavily freshness=month

输出多条资讯 URL。

步骤 2：静态页面 → web_fetch 批量读取全文

plaintext

/web_fetch url=https://xxx.industry.com/report

步骤 3：遇到动态 JS 页面 → 切换 browser 完整渲染

plaintext

/skill browser-use open https://xxx.spa-industry.com
/skill browser-use snapshot

步骤 4：如需百度本土结果，直接用 browser 操作baidu.com

plaintext

/skill browser-use open https://www.baidu.com
/skill browser-use input 搜索框 深紫外激光器2026市场分析
/skill browser-use click 百度一下
/skill browser-use snapshot

五、核心区分对照表

表格

工具	输入内容	是否需要 API 密钥	能否执行 JS	能否全网关键词搜索	能否操作百度搜索框	资源占用
web_search	文字关键词	是 (Tavily/Brave)	否	✅ 专门全网检索	❌ 不访问百度	极低
web_fetch	单个 URL	无需密钥	❌ 仅静态 HTML	❌ 只能读页面	✅ 仅打开首页，无法交互搜索	低
browser	URL + 点击 / 输入指令	无需密钥	✅ 完整渲染	❌ 无搜索能力	✅ 完整百度网页检索交互	高

六、高频易错点

1. web_search 不能填网址，输入 URL 直接报错；web_fetch/browser 只能填 URL，不能直接关键词搜索
2. web_search (Brave/Tavily) ≠ 百度搜索：前者是第三方海外 API，后者只能通过 browser 打开baidu.com手动检索
3. web_fetch 抓不到动态商品、登录后台，必须使用 browser
4. 新装 OpenClaw web_search 默认无法使用，必须配置 Tavily/Brave 密钥；web_fetch 开箱即用
5. browser 默认关闭，不开启配置无法调用浏览器相关命令