介绍
# OmniSearch Skill - Web Search Tool
## 关键:何时使用此技能
**务必在以下情况使用 OmniSearch:** - 用户明确要求“搜索”、“谷歌”、“查找”、“在网上找” - 用户询问时事、新闻或最新进展 - 用户请求价格、产品规格、评测或对比 - 用户问“最新的……是什么”或“……目前什么情况” - 你需要验证当前的事实、统计数据或数据 - 用户询问你不知道的人物、公司或组织 - 信息自你的训练截止日期后可能已发生变化 - 用户需要事实性陈述的来源或引用
**需要使用 OmniSearch 的查询示例:** - “汉堡今天的天气怎么样?” - “搜索 iPhone 16 评测” - “本周科技界发生了什么?” - “查找比特币当前价格” - “查找我附近的餐厅” - “大家对新款特斯拉车型有什么评价?”
## 请勿在以下情况使用 OmniSearch: - 从你现有的知识库回答已足够且具有时效性 - 用户要求创意内容、代码或分析 - 问题涉及概念、定义或永恒不变的信息
---
## 如何执行搜索
**重要**:请使用相对路径 `./scripts/omnisearch.sh` 从 omnisearch 技能目录运行脚本。
### 方法 1:推荐(封装脚本)
对所有搜索使用封装脚本:
```bash # AI-enhanced search (includes summarization) - USE THIS FOR MOST QUERIES ./scripts/omnisearch.sh ai "your search query here"
# Raw web search results (when you need direct source material) ./scripts/omnisearch.sh web "your search query here" ```
**可用提供商:** - **ai** 类型:`perplexity`(默认 - 推荐用于大多数查询) - **web** 类型:`perplexity`(默认)、`brave`、`kagi`、`tavily`、`exa`
**可选的提供商覆盖:** ```bash ./scripts/omnisearch.sh ai "query" perplexity ./scripts/omnisearch.sh web "query" brave ./scripts/omnisearch.sh web "query" kagi ./scripts/omnisearch.sh web "query" tavily ./scripts/omnisearch.sh web "query" exa ```
**实用示例:** ```bash # Current weather ./scripts/omnisearch.sh ai "weather in Hamburg today"
# Product research ./scripts/omnisearch.sh web "iPhone 16 Pro reviews 2024"
# News search ./scripts/omnisearch.sh ai "latest AI developments this week"
# Price comparison ./scripts/omnisearch.sh web "DJI Mini 4 Pro price Germany" brave
# Research with premium provider ./scripts/omnisearch.sh web "machine learning papers 2024" kagi ```
### 方法 2:备选(直接调用 mcporter)
仅在封装脚本失败时使用:
```bash mcporter call omnisearch.ai_search query="your search query" provider="perplexity" mcporter call omnisearch.web_search query="your search query" provider="brave" ```
---
## 响应格式
收到搜索结果后,务必:
1. **总结**:用 2-5 个关键要点列出最相关的发现 2. **引用来源**:包含 2-6 个格式化为可点击链接的来源 URL 3. **添加上下文**:注明信息是否具有时效性或置信度较低 4. **直接回答**:不要只是堆砌结果 - 要综合并回答用户的问题
**响应结构示例:** ``` Based on my search, here's what I found:
- [Key finding 1] - [Key finding 2] - [Key finding 3]
Sources: - [Title 1](URL1) - [Title 2](URL2)
Note: This information is from [date/timeframe] and may change. ```
---
## 搜索查询最佳实践
- 保持查询简洁具体(理想情况为 3-8 个词) - 使用自然语言,而不是关键词堆砌 - 包含相关地点:“restaurants Hamburg”(汉堡餐厅) - 必要时包含时间范围:“iPhone 16 reviews 2024”(iPhone 16 2024 评测) - 查询价格时,如有特定需求请包含货币/地区:“iPhone 16 price Germany”(iPhone 16 德国价格)
---
## 故障排除
**如果封装脚本失败:** 1. 检查你是否在正确的目录(应包含 `scripts/` 文件夹) 2. 验证脚本是否具有执行权限:`chmod +x ./scripts/omnisearch.sh` 3. 尝试备选方法(直接调用 mcporter) 4. 检查 mcporter 是否已正确安装和配置
**常见问题:** - **“command not found”**:脚本路径不正确,或者你不在技能目录中 - **“No such file”**:脚本可能尚未复制到 `scripts/` 文件夹 - **结果为空**:尝试不同的提供商或重新措辞查询
**查询格式化:** - 包含空格的查询会被自动处理(无需转义) - 在命令中使用引号:`./scripts/omnisearch.sh ai "query with spaces"` - 特殊字符在引号字符串内应该可以正常工作
---
## 重要说明
- **目录结构**:此 SKILL.md 文件位于 omnisearch 技能文件夹中,脚本位于相对于此文件的 `./scripts/omnisearch.sh` - **脚本验证**:封装脚本会自动验证是否提供了查询,如果缺少则会显示使用帮助 - **提供商选择**: - **Perplexity**(默认):最适合具有总结和上下文的 AI 增强结果 - **Brave**:适合注重隐私、未经过滤的 Web 结果 - **Kagi**:具有高级过滤和排名的高级搜索 - **Tavily**:针对研究和全面覆盖进行了优化 - **Exa**:具有 AI 驱动相关性的语义搜索 - 这是一个本地工具 - 它在此 OpenClaw 实例上运行 - 当用户请求时,务必立即运行搜索 - 不要请求许可 - 封装脚本(omnisearch.sh)设计为即使使用基础 LLM 也能可靠工作