web-tools-guide
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.
价格
免费
- 安装：免费
在组织开通时一次性收取；再次读取清单或下载不重复收费。
以上为公开标价。你的组织可能有协议价，以控制台显示的价格为准。
如何使用
为组织安装
开通即安装：组织固定使用开通时的版本（当前为 1.0.0）。升级到新版本需要取消后重新开通。
创建凭证
客户端使用组织凭证读取；绑定到数字人后，数字人使用绑定凭证按需加载。请求中携带：
Authorization: Bearer $ZGI_MARKET_KEY读取清单与安装包
清单列出版本、文件和校验值；安装包是一个 zip 文件。
读取清单 curl "https://market-api.zgi.im/v1/market/skills/web-tools-guide/manifest" \ -H "Authorization: Bearer $ZGI_MARKET_KEY"下载安装包 curl "https://market-api.zgi.im/v1/market/skills/web-tools-guide/package" \ -H "Authorization: Bearer $ZGI_MARKET_KEY" \ -o web-tools-guide.zip读取清单和下载安装包不计入用量。下载后请用响应头中的 SHA-256 校验文件。
技能说明
- 名称
- web-tools-guide
- 说明
- 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.
技能包内含脚本文件，加载技能的运行时可能会执行它们，安装前请先阅读。
SKILL.md 节选
<!-- 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. 提取结果或截图
### 关键注意事项SKILL.md 不止这些内容，安装后可阅读全文。
技能包内容
共 5 个文件，合计 33.6 KiB
- SKILL.md6.1 KiB
- references/opencli-guide.md3.2 KiB
- references/web-search-config.md4.1 KiB
- references/well-known-sites.json7.9 KiB
- scripts/setup-opencli.sh12.2 KiB
来源与审核
- 审核状态
- 尚未审核，内容来自上游来源
- 许可证
- 未说明
审核状态是平台对上架信息的记录，不构成对上游服务质量或可用性的担保。