據 AlphaMoat 統計,截至 2026-10,web-tools-guide 累計下載 5,796 次、獲 0 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 4,989 位,在「知識管理」分類(745 個)中排名第 348 位。
列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。
| 平台 | 累計下載 | 星標 | 評論 |
|---|---|---|---|
| ClawHub ↗ | 5796 | - | - |
各平台的計數口徑不同,統計時間不一致。
該指南要求先嚐試適合場景的 web_search 或 web_fetch,失敗時按順序嘗試 OpenCLI,再在必要時使用瀏覽器;切換工具應說明原因。搜尋 API 出錯需遵循配置引導。登入必須先告知使用者並取得授權,發帖、刪除、支付等敏感動作需再次確認。OpenCLI 安裝會從外部來源獲取程式碼並可能重啟瀏覽器;API 金鑰不可貼上到聊天或暴露在日誌、程序引數中。 該回退順序是指南建議,工具是否可用取決於執行環境。
資料釋出於 2026-10-29
以下是根據技能文件生成的示例,不代表實際執行結果。
| 月份 | 累計下載 | 環比 | 星標 |
|---|---|---|---|
| 2026-10 | 5796 | — | - |
| 2026-09 | 5370 | — | - |
以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 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),按月更新。口徑說明見資料方法。