前言¶
辦公里很多環節離不開「先查清楚再動筆」：競品動態、政策條文、行業新聞、配圖素材，往往要在瀏覽器和文檔之間來回切換。模型自帶的訓練數據有截止時間，直接問也容易過時；自己開搜索頁再複製粘貼，則難沉澱成可複用的 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。
