FMLS

web-tools-guide

知識管理v1.0.2
作者:FMLS更新於 2026-05-11共 3 個版本 · 最新版本釋出於 2026-04-14
#Web Search#Browser#新闻

據 AlphaMoat 統計,截至 2026-10,web-tools-guide 累計下載 5,796 次、獲 0 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 4,989 位,在「知識管理」分類(745 個)中排名第 348 位。

列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。

累計下載
5796
星標
-
全站下載量排名
#4,989
全站前 46% · 「知識管理」前 47%
平台累計下載星標評論
ClawHub ↗5796--

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

該指南要求先嚐試適合場景的 web_search 或 web_fetch,失敗時按順序嘗試 OpenCLI,再在必要時使用瀏覽器;切換工具應說明原因。搜尋 API 出錯需遵循配置引導。登入必須先告知使用者並取得授權,發帖、刪除、支付等敏感動作需再次確認。OpenCLI 安裝會從外部來源獲取程式碼並可能重啟瀏覽器;API 金鑰不可貼上到聊天或暴露在日誌、程序引數中。 該回退順序是指南建議,工具是否可用取決於執行環境。

資料釋出於 2026-10-29

可以用來做什麼

  • 為已知 URL 的靜態網頁選擇抓取方式
  • 為需要關鍵詞發現的主題規劃搜尋與後續讀取步驟
  • 在登入、頁面互動或敏感操作前整理所需確認事項

什麼時候用

  • 需要選擇網頁搜尋、頁面抓取或瀏覽器訪問路徑時
  • 執行登入、安裝外部元件或可能改變賬號狀態前可先取得明確授權時

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

根據這個網頁任務判斷合適的訪問路徑,只說明建議和可能的資料/瀏覽器影響;不要聯網、安裝元件、登入或執行頁面操作。

月度資料趨勢

累計下載5796
5336558358302026-09 · 累計下載 53702026-10 · 累計下載 579626-0926-10
星標-
0112026-09 · 星標 -2026-10 · 星標 -26-0926-10
月份累計下載環比星標
2026-105796—-
2026-095370—-

SKILL.md 原文

以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 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 范式。**四个工具不是层级关系,是分支决策**:
展開全部(共 160 行)

```
┌─ 没有 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 使用者要求“搜一下/查資料/多找幾個來源/核實訊息/找公眾號文章/排查報錯/找論文或開源專案”時。輸入自然語言查詢詞,輸出帶來源連結與可信度標註的結構化結果。不適用於私有資料檢索、批次抓取、需要登入後可見的內容。

↓ 1075.9萬★ 147u_8ee34d77
ima-skills知識管理

透過 IMA OpenAPI 管理筆記與知識庫內容。

↓ 108.4萬★ 566u_1742680f
Summarize知識管理

把長文字、文件與網頁內容壓縮成要點和關鍵詞的摘要工具。

↓ 87.6萬★ 1048paudyyin
全網搜尋知識管理

透過“查一下、搜一下、搜尋、找一下”等自然語言檢索公開網頁,整理來源並交付橫版 PDF、Markdown 與標題連結表。支援使用者主動開啟、檢視和取消技能收藏,保留原報告取回。

↓ 50.9萬★ 2u_32d99f8a
web-tools-guide知識管理

規定如何為網頁請求選擇合適工具的必讀指引。

↓ 40萬★ 220user_ec205dbb
Aihot Skill Lite知識管理

AI HOT(aihot.virxact.com)中文 AI 資訊查詢 Skill,幫助使用者獲取今日 AI 圈動態、AI 日報、AI 熱點、最新 AI 資訊以及 OpenAI、Anthropic、Google 等公司的最新發布資訊。

↓ 32.1萬★ 92Khazix
全球12億文獻知識庫(8千萬中文期刊可下載)知識管理

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

↓ 30.3萬★ 189user_164f4c1f
Markdown Converter知識管理

用 uvx 直接呼叫 markitdown,把各類檔案轉成 Markdown。

↓ 20.4萬★ 256Peter Steinberger

資料月份:2026-10 · 下載/星標數聚合自公開技能註冊庫(ClawHub、SkillHub),按月更新。口徑說明見資料方法。