据 AlphaMoat 统计,截至 2026-10,web-tools-guide 累计下载 5,796 次、获 0 个星标,按累计下载量在本次参与排名的 10,914 个 AI 技能中排名第 4,989 位,在「知识管理」分类(745 个)中排名第 348 位。
列表默认按累计下载量排序,也可按星标排序;详情页排名按累计下载量计算。
| 平台 | 累计下载 | 星标 | 评论 |
|---|---|---|---|
| ClawHub ↗ | 5,796 | - | - |
各平台的计数口径不同,统计时间不一致。
该指南要求先尝试适合场景的 web_search 或 web_fetch,失败时按顺序尝试 OpenCLI,再在必要时使用浏览器;切换工具应说明原因。搜索 API 出错需遵循配置引导。登录必须先告知用户并取得授权,发帖、删除、支付等敏感动作需再次确认。OpenCLI 安装会从外部来源获取代码并可能重启浏览器;API 密钥不可粘贴到聊天或暴露在日志、进程参数中。 该回退顺序是指南建议,工具是否可用取决于运行环境。
资料发布于 2026-10-29
以下是根据技能文档生成的示例,不代表实际运行结果。
| 月份 | 累计下载 | 环比 | 星标 |
|---|---|---|---|
| 2026-10 | 5,796 | — | - |
| 2026-09 | 5,370 | — | - |
以下是作者发布的原始文件,按纯文本显示,本站未做修改或审核;其中的链接不可点击,命令请核实后再运行。抓取于 2026-10-23。
--- name: web-tools-guide description: "MANDATORY before calling web_search, web_fetch, browser, or opencli. Contains required error-handling procedures (web_search failure → must guide user to configure API), fallback chain (opencli CLI covers 70+ sites as structured fallback before browser), and site-specific login URLs. Without reading this skill, you WILL handle failures incorrectly and miss available tools. Trigger on: 搜索/上网/查资料/打开网站/抓取网页/新闻/热点/web search/fetch/browser/opencli." --- <!-- baseDir = /root/.openclaw/workspace/skills/web-tools-guide --> # Web 工具策略 遵循 ReAct 范式。**四个工具不是层级关系,是分支决策**:
```
┌─ 没有 URL,需要搜索 ──────→ web_search (关键词搜索)
│
├─ 已知 URL,静态内容 ──────→ web_fetch (直取页面)
│
├─ 以上失败 / 不适用 ──────→ opencli (CLI 结构化访问,70+ 站点)
│
└─ 全都不行 ───────────────→ browser (浏览器自动化,兜底)
```
先按场景选 web_search 或 web_fetch;失败时先试 opencli,最后才上 browser。
每次切换工具告知用户原因,不要静默降级。
---
## 决策流程
```
有明确 URL?
├─ YES → 静态内容(文章/文档/API/RSS)?
│ ├─ YES → web_fetch
│ │ 失败(空白/403/CAPTCHA)?→ opencli → browser
│ └─ NO(需要 JS/登录/交互/截图)→ opencli → browser
└─ NO → web_search
├─ 成功 → 对结果 URL 按上述逻辑选 fetch/opencli/browser
├─ 失败(API 错误)→ 引导配置(见"web_search 失败处理")
└─ 无结果/不适用 → opencli → browser
```
---
## web_search
**何时用**:没有明确 URL,需要搜索信息(新闻、热点、查资料、比较信息)。
**怎么用**:直接调用 `web_search`,传入搜索关键词。
**结果处理**:返回的 URL 按决策流程选 `web_fetch`、`opencli` 或 `browser` 深入获取。
**失败时**:见下方"web_search 失败处理"。
---
## web_fetch
**何时用**:已知 URL,页面为静态内容——新闻文章、博客、技术文档、API 端点、RSS 源。
**怎么用**:直接调用 `web_fetch`,传入 URL。
**失败信号**:返回空白页、403、CAPTCHA、骨架 HTML → 尝试 `opencli`,仍不行再升级到 `browser`。
---
## opencli(Fallback,优先于 browser)
**何时用**:web_search / web_fetch 失败或不适用时,先试 opencli 再考虑 browser。覆盖 70+ 主流网站,秒级返回结构化数据。
**首次使用前**:如果执行 `opencli` 提示 command not found,需要先运行安装脚本(幂等,可重复运行):
```bash
bash {baseDir}/scripts/setup-opencli.sh
```
该脚本会自动完成:安装 opencli CLI → 编译 Browser Bridge 插件 → 重启浏览器加载插件。
**渐进式发现(不需要记命令)**:
```bash
opencli --help # 有没有这个站?
opencli <site> --help # 这个站能做什么?
opencli <site> <command> --help # 这个命令怎么用?
```
**详细用法**:`read {baseDir}/references/opencli-guide.md`
**失败时**:告知用户 opencli 失败原因,降级到 browser。
---
## browser(最后手段)
这是最重量级的工具,也是当前问题最多的场景。以下是详细操作指引。
### 何时用
- **JS 渲染页面**:SPA、动态加载内容(微博 feed、知乎回答、小红书瀑布流)
- **需要登录态**:登录后才可见的内容、管理后台
- **页面交互**:点击按钮、填写表单、翻页、滚动加载更多
- **截图需求**:需要页面视觉信息
- **其他工具全部失败的兜底**
### 操作流程
**信息获取(只读):**
1. 导航到目标 URL
2. 等待关键元素出现(不要用固定时间等待)
3. 提取所需内容(文本、链接、图片等)
4. 返回结果给用户
**登录操作:**
1. 查找登录页 URL → `read {baseDir}/references/well-known-sites.json`
2. **告知用户即将执行登录操作,获取确认**
3. 导航到登录页
4. 填写凭证(用户提供)或提示用户扫码
5. 等待登录成功,确认后继续后续操作
**页面交互:**
1. 导航到目标页面
2. 使用 CSS 选择器定位元素(辅以文本内容匹配)
3. 执行交互:点击、输入、选择、滚动
4. 等待响应/页面变化
5. 提取结果或截图
### 关键注意事项
- **登录操作必须获得用户授权** — 任何涉及账号登录的操作前,先告知用户并等待确认
- **敏感操作必须二次确认** — 发帖、删除、支付等不可逆操作
- **优先 CSS 选择器** — 比 XPath 更稳定,辅以文本匹配
- **智能等待** — 等待目标元素出现,而非 `sleep(3)` 式固定等待
- **CAPTCHA/验证码** — 无法自动处理时告知用户需手动介入
- **页面加载超时** — 设置合理超时,失败时告知用户并建议重试
- **多步操作保持状态** — 登录后的后续操作复用同一浏览器上下文,不要重新打开
---
## web_search 失败处理
**当 `web_search` 返回错误时,不要静默降级,必须引导配置:**
1. **`read {baseDir}/references/web-search-config.md`**
2. 按文件中 Step 1 **原样输出**配置引导给用户(不要改写表格或省略内容)
3. 等待用户回复:
- 用户提供 API Key → 再次 `read {baseDir}/references/web-search-config.md`,按 Step 2-5 执行
- 用户说"暂不配置" → 进入降级方案
- 其他回复 → 正常响应
4. **降级方案**(仅在用户明确拒绝配置后):
- `read {baseDir}/references/well-known-sites.json` 获取常用网站 URL
- 用 `web_fetch` 直接获取目标网站内容
- 仍不行 → 升级到 `browser`
---
## 常用网站
需要常用网站 URL 时(登录页、搜索引擎、热搜榜等):
```
read {baseDir}/references/well-known-sites.json
```
通过 key 查找(如 `social.weibo.login`、`search.baidu`)。带 `{query}` 的 URL 替换为实际搜索词。
通过公开搜索URL在16个搜索引擎(7个国内直连+9个国际)中做跨引擎检索、结果去重与多源交叉验证,无需API Key,内置零依赖Python脚本。Use when 用户要求“搜一下/查资料/多找几个来源/核实消息/找公众号文章/排查报错/找论文或开源项目”时。输入自然语言查询词,输出带来源链接与可信度标注的结构化结果。不适用于私有数据检索、批量抓取、需要登录后可见的内容。
通过 IMA OpenAPI 管理笔记与知识库内容。
把长文本、文档与网页内容压缩成要点和关键词的摘要工具。
通过“查一下、搜一下、搜索、找一下”等自然语言检索公开网页,整理来源并交付横版 PDF、Markdown 与标题链接表。支持用户主动开启、查看和取消技能收藏,保留原报告取回。
规定如何为网页请求选择合适工具的必读指引。
AI HOT(aihot.virxact.com)中文 AI 资讯查询 Skill,帮助用户获取今日 AI 圈动态、AI 日报、AI 热点、最新 AI 资讯以及 OpenAI、Anthropic、Google 等公司的最新发布信息。
全球12亿文献知识库(8千万中文期刊可下载)——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力,覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据(期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万)。 能力:中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载(不消耗配额)、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额:首次使用自动注册,免费 100 次检索 + 10 次下载 / 月;耗尽自动弹出套餐(体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包),可说「升级 / 充值」唤起;企业 / 机构定制联系 [email protected]。 触发:用户表达"查论文""找文献""检索学术""搜期刊""查专利""找标准""下论文""写文献综述""找参考文献""查 SCI/EI"等意图时启用;也适用"帮我找关于 XX 的论文""写文献综述""找几篇引用支撑论点"。英文:"find papers" "search literature" "write literature review" "find supporting citations"。 调用前必须先用 /consume 获取 consume_token,再凭 token 调 /search(每次计费接口调用都需一次 /consume)。
用 uvx 直接调用 markitdown,把各类文件转成 Markdown。
数据月份:2026-10 · 下载/星标数聚合自公开技能注册库(ClawHub、SkillHub),按月更新。口径说明见数据方法。