FMLS

web-tools-guide

Knowledgev1.0.2
By FMLSUpdated 2026-05-113 versions · latest released 2026-04-14
#Web Search#Browser#新闻

According to AlphaMoat, as of 2026-10, web-tools-guide has 5,796 downloads and 0 stars — ranked by downloads #4,989 among 10,914 AI skills in this ranking, and #348 of 745 in Knowledge.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
5.8K
Stars
-
Overall download rank
#4,989
Top 46% overall · Top 47% in Knowledge
PlatformDownloadsStarsComments
ClawHub ↗5.8K--

Platforms count differently and update at different times.

What this skill does

The guide says to begin with the appropriate web_search or web_fetch path, try OpenCLI on failure, and use the browser only when needed; explain each tool switch. Follow its configuration guidance when search APIs fail. Login requires prior notice and authorization, and sensitive actions such as posting, deletion, or payment require another confirmation. OpenCLI setup downloads external code and may restart the browser; never paste API keys into chat or expose them in logs or process arguments. The fallback describes a proposed tool sequence; availability depends on the host environment.

Profile published 2026-10-29

What you can do with it

  • Choose a retrieval path for a known static URL
  • Plan search and follow-up retrieval for a topic requiring discovery
  • Prepare the confirmations needed before login, page interaction, or sensitive actions

When to use it

  • When deciding whether web search, page fetching, or browser access is appropriate
  • When explicit authorization can be obtained before login, installing external components, or changing account state

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

For this web task, recommend an access path and explain possible data or browser effects only. Do not access the network, install components, log in, or operate a page.

Monthly Trend

Downloads5.8K
5.3K5.6K5.8K2026-09 · Downloads 5.4K2026-10 · Downloads 5.8K26-0926-10
Stars-
0112026-09 · Stars -2026-10 · Stars -26-0926-10
MonthDownloadsMoMStars
2026-105.8K—-
2026-095.4K—-

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

6.1 KB · ClawHub v1.0.2
---
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 范式。**四个工具不是层级关系,是分支决策**:
Show all (160 lines)

```
┌─ 没有 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 替换为实际搜索词。

Popular in Knowledge

搜索引擎Knowledge

通过公开搜索URL在16个搜索引擎(7个国内直连+9个国际)中做跨引擎检索、结果去重与多源交叉验证,无需API Key,内置零依赖Python脚本。Use when 用户要求“搜一下/查资料/多找几个来源/核实消息/找公众号文章/排查报错/找论文或开源项目”时。输入自然语言查询词,输出带来源链接与可信度标注的结构化结果。不适用于私有数据检索、批量抓取、需要登录后可见的内容。

↓ 10.8M★ 147u_8ee34d77
ima-skillsKnowledge

Manage notes and knowledge-base content through the IMA OpenAPI.

↓ 1.1M★ 566u_1742680f
SummarizeKnowledge

A summarizer that condenses long text, documents, and web pages into key points and keywords.

↓ 876.3K★ 1.0Kpaudyyin
全网搜索Knowledge

通过“查一下、搜一下、搜索、找一下”等自然语言检索公开网页,整理来源并交付横版 PDF、Markdown 与标题链接表。支持用户主动开启、查看和取消技能收藏,保留原报告取回。

↓ 508.8K★ 2u_32d99f8a
web-tools-guideKnowledge

A required guide for routing web requests to the right tool.

↓ 399.8K★ 220user_ec205dbb
Aihot Skill LiteKnowledge

AI HOT (aihot.virxact.com) 中文 AI 资讯查询 Skill。当用户想知道"今天 AI 圈有什么"、"AI 日报"、"AI HOT"、"AI 资讯"、"AI 热点"、"最近 AI"、"OpenAI/Anthropic/Google 最近发布了什么"、"AI hot today"、"AI...

↓ 321.1K★ 92Khazix
全球12亿文献知识库(8千万中文期刊可下载)Knowledge

全球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)。

↓ 303.0K★ 189user_164f4c1f
Markdown ConverterKnowledge

Calls markitdown through uvx to turn many file types into Markdown.

↓ 204.0K★ 256Peter Steinberger

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.