前言¶
办公里很多环节离不开「先查清楚再动笔」：竞品动态、政策条文、行业新闻、配图素材，往往要在浏览器和文档之间来回切换。模型自带的训练数据有截止时间，直接问也容易过时；自己开搜索页再复制粘贴，则难沉淀成可复用的 Markdown 或 JSON。
下面介绍的是 SkillHub 上的 Web Search（坐标 @clawhub_billyutw/web-search）。它把 DuckDuckGo 检索封装成 Agent 可调用的能力，默认不需要 API Key，结果可按文本、Markdown 或 JSON 输出，便于写纪要、做事实核对或整理资料清单。
这是什么¶
Web Search 由发布者 billyutw 维护，上游仓库在 clawhub.ai/billyutw/web-search，在 SkillHub 归类为知识/信息检索（页面标签为「信息检索」）。当前版本 v1.0.0，标签标明 requires_api_key=false。
一句话定位：在用户需要查网页、新闻、图片或视频时，通过 DuckDuckGo 搜索接口返回简洁、可格式化的结果，用于研究、事实核查、获取较新信息或收集网络资源。
SkillHub 展示页：https://www.skillhub.cn/skills/clawhub_billyutw/web-search
组织入口：https://api.skillhub.cn/org-02qudk26/web-search
核心功能¶
以下能力均来自官方 Skill 说明，经 ClawHub 页面核对：
- 多类型检索：网页（web）、新闻（news）、图片（images）、视频（videos）。
- 结果数量与时间：
--max-results控制条数；--time-range支持d（一天）、w（一周）、m（一月）、y（一年）。 - 区域与安全搜索：
--region（如us-en、wt-wt）；--safe-search为on/moderate/off。 - 图片与视频筛选：图片侧含尺寸、颜色、类型、版式等参数；视频侧含时长、分辨率等参数（详见上游文档）。
- 输出格式：
text（默认）、markdown、json；可用--output写入文件。 - 命令行入口：Skill 内提供
scripts/search.py，依赖 Python 包duckduckgo-search，无需 DuckDuckGo API Key。
安装与启用¶
在 SkillHub / 支持 Skill 的 Agent 中安装¶
SkillHub 页面给出的安装方式是：让 AI 按 skillhub.cn/install/skillhub.md 的说明，安装坐标 @clawhub_billyutw/web-search。也可在 SkillHub 下载 Zip 或按页面提示安装到本地 Agent。
向 Agent 发送的提示词示例（与官网一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@clawhub_billyutw/web-search`。
OpenClaw 环境¶
ClawHub 上游文档给出的命令为：
openclaw skills install @billyutw/web-search
运行前依赖¶
安装 Skill 后，若直接调用脚本，需先安装 Python 依赖：
pip install duckduckgo-search
典型用法¶
Skill 安装并具备 scripts/search.py 后，可在项目目录或 Skill 目录下执行下列命令（示例来自官方文档）。
基础网页搜索（默认约 10 条，纯文本）：
python scripts/search.py "python asyncio tutorial"
限制条数：
python scripts/search.py "machine learning frameworks" --max-results 20
近一周新闻：
python scripts/search.py "artificial intelligence news" --time-range w
python scripts/search.py "climate change" --type news --time-range w --max-results 15
Markdown 输出并保存（适合直接贴进办公文档）：
python scripts/search.py "quantum computing" --format markdown --output quantum.md
JSON 输出（适合后续脚本处理）：
python scripts/search.py "quantum computing" --format json --output quantum.json
在 Agent 对话中，通常不必手写上述命令：说明检索意图（类型、时间范围、条数、输出格式），由 Agent 按 Skill 指引调用脚本即可。完整参数列表可执行：
python scripts/search.py --help
适用场景与注意¶
适合谁
- 需要把「查资料」嵌进 Agent 工作流的白领或知识工作者：写简报前拉新闻、做竞品摘录、核对公开信息、收集图片/视频链接等。
- 希望结果结构化（尤其 Markdown / JSON），而不是零散复制网页片段的场景。
使用上可注意
- 检索质量取决于 DuckDuckGo 索引与排序，与 Google 等引擎结果可能不一致；官方说明未提供
site:、filetype:等高级运算符。 - 频繁、连续请求可能遇到限流或超时，宜控制频率；无结果时可放宽时间过滤或改写查询词。
- 缺少依赖时会报错，需确认已执行
pip install duckduckgo-search。 - SkillHub 页面显示该包经科恩实验室、云鼎实验室等安全扫描为无风险，仍应对返回 URL 与内容自行判断可信度。
结尾¶
Web Search 把常见的网页、新闻、图片、视频检索收敛到同一套脚本与输出格式，在不需要 API Key 的前提下，方便 Agent 完成「搜索 → 结构化结果 → 落盘或续写文档」的链条。若要在本地或 SkillHub 启用，可从官方页获取安装方式：https://api.skillhub.cn/org-02qudk26/web-search。
