名称: openclaw-search
描述: "智能搜索代理。多源检索与置信度评分——集成网页、学术和Tavily的统一API。"
主页: https://openclaw.ai
元数据: {"openclaw":{"emoji":"🔍","requires":{"bins":["curl","python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}
为自主智能体提供智能搜索。由 AIsa 驱动。
一个 API 密钥。多源检索。置信度评分答案。
灵感来源于 AIsa Verity —— 一个提供可信度评分答案的新一代搜索代理。
"搜索 2024-2025 年关于 Transformer 架构的最新论文"
"查找 2025 年第四季度关于 AI 初创公司融资的所有网络文章"
"搜索 RAG 框架的评测与对比"
"获取关于量子计算突破的最新新闻"
"结合网络与学术资源对‘自主智能体’进行智能搜索"
export AISA_API_KEY="你的密钥"
OpenClaw Search 采用 两阶段检索策略 以获得全面结果:
同时查询 4 个独立的搜索流:
- 学术搜索:深度学术检索
- 网页搜索:结构化网页搜索
- 智能搜索:智能混合模式搜索
- Tavily 搜索:外部验证信号
使用 AIsa Explain 对搜索结果进行元分析,生成:
- 置信度分数(0-100)
- 来源一致性分析
- 综合答案
┌─────────────────────────────────────────────────────────────┐
│ 用户查询 │
└─────────────────────────────────────────────────────────────┘
│
┌───────────────┼───────────────┐
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐
│ 学术搜索 │ │ 网页搜索 │ │ 智能搜索 │
└─────────┘ └─────────┘ └─────────┘
│ │ │
└───────────────┼───────────────┘
▼
┌─────────────────┐
│ AIsa Explain │
│ (元分析) │
└─────────────────┘
│
▼
┌─────────────────┐
│ 置信度评分 │
│ + 综合答案 │
└─────────────────┘
# 基础网页搜索
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/web?query=AI+frameworks&max_num_results=10" \
-H "Authorization: Bearer $AISA_API_KEY"
# 全文搜索(包含页面内容)
curl -X POST "https://api.aisa.one/apis/v1/search/full?query=latest+AI+news&max_num_results=10" \
-H "Authorization: Bearer $AISA_API_KEY"
# 搜索学术论文
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=transformer+models&max_num_results=10" \
-H "Authorization: Bearer $AISA_API_KEY"
# 带年份过滤
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=LLM&max_num_results=10&as_ylo=2024&as_yhi=2025" \
-H "Authorization: Bearer $AISA_API_KEY"
# 智能混合搜索
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/smart?query=machine+learning+optimization&max_num_results=10" \
-H "Authorization: Bearer $AISA_API_KEY"
# Tavily 搜索
curl -X POST "https://api.aisa.one/apis/v1/tavily/search" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"latest AI developments"}'
# 从 URL 提取内容
curl -X POST "https://api.aisa.one/apis/v1/tavily/extract" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://example.com/article"]}'
# 爬取网页
curl -X POST "https://api.aisa.one/apis/v1/tavily/crawl" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com","max_depth":2}'
# 站点地图
curl -X POST "https://api.aisa.one/apis/v1/tavily/map" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'
# 生成带置信度评分的解释
curl -X POST "https://api.aisa.one/apis/v1/scholar/explain" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"results":[...],"language":"en","format":"summary"}'
与标准 RAG 系统不同,OpenClaw Search 评估可信度和共识:
| 因素 | 权重 | 描述 |
|---|---|---|
| 来源质量 | 40% | 学术 > 智能/网页 > 外部 |
| 一致性分析 | 35% | 跨来源共识检查 |
| 时效性 | 15% | 较新的来源权重更高 |
| 相关性 | 10% | 查询-结果语义匹配度 |
| 分数 | 置信度等级 | 含义 |
|---|---|---|
| 90-100 | 非常高 | 学术和网络来源间有强烈共识 |
| 70-89 | 高 | 良好的一致性,可靠来源 |
| 50-69 | 中等 | 信号混杂,建议独立验证 |
| 30-49 | 低 | 来源冲突,谨慎使用 |
| 0-29 | 非常低 | 数据不足或相互矛盾 |
# 网页搜索
python3 {baseDir}/scripts/search_client.py web --query "latest AI news" --count 10
# 学术搜索
python3 {baseDir}/scripts/search_client.py scholar --query "transformer architecture" --count 10
python3 {baseDir}/scripts/search_client.py scholar --query "LLM" --year-from 2024 --year-to 2025
# 智能搜索(网页 + 学术)
python3 {baseDir}/scripts/search_client.py smart --query "autonomous agents" --count 10
# 全文搜索
python3 {baseDir}/scripts/search_client.py full --query "AI startup funding"
# Tavily 操作
python3 {baseDir}/scripts/search_client.py tavily-search --query "AI developments"
python3 {baseDir}/scripts/search_client.py tavily-extract --urls "https://example.com/article"
# 带置信度评分的多源搜索
python3 {baseDir}/scripts/search_client.py verity --query "Is quantum computing ready for enterprise?"
| 端点 | 方法 | 描述 |
|---|---|---|
/scholar/search/web |
POST | 结构化结果的网页搜索 |
/scholar/search/scholar |
POST | 学术论文搜索 |
/scholar/search/smart |
POST | 智能混合搜索 |
/scholar/explain |
POST | 生成结果解释 |
/search/full |
POST | 包含内容的全文搜索 |
/search/smart |
POST | 智能网页搜索 |
/tavily/search |
POST | Tavily 搜索集成 |
/tavily/extract |
POST | 从 URL 提取内容 |
/tavily/crawl |
POST | 爬取网页 |
/tavily/map |
POST | 生成站点地图 |
| 参数 | 类型 | 描述 |
|---|---|---|
| query | string | 搜索查询(必需) |
| max_num_results | integer | 最大结果数(1-100,默认 10) |
| as_ylo | integer | 起始年份下限(仅学术搜索) |
| as_yhi | integer | 结束年份上限(仅学术搜索) |
想构建自己的置信度评分搜索代理吗?以下是模式:
import asyncio
async def discover(query):
"""阶段 1:从多个来源并行检索。"""
tasks = [
search_scholar(query),
search_web(query),
search_smart(query),
search_tavily(query)
]
results = await asyncio.gather(*tasks)
return {
"scholar": results[0],
"web": results[1],
"smart": results[2],
"tavily": results[3]
}
def score_confidence(results):
"""计算确定性置信度分数。"""
score = 0
# 来源质量 (40%)
if results["scholar"]:
score += 40 * len(results["scholar"]) / 10
# 一致性分析 (35%)
claims = extract_claims(results)
agreement = analyze_agreement(claims)
score += 35 * agreement
# 时效性 (15%)
recency = calculate_recency(results)
score += 15 * recency
# 相关性 (10%)
relevance = calculate_relevance(results, query)
score += 10 * relevance
return min(100, score)
async def synthesize(query, results, score):
"""生成带引用的最终答案。"""
explanation = await explain_results(results)
return {
"answer": explanation["summary"],
"confidence": score,
"sources": explanation["citations"],
"claims": explanation["claims"]
}
完整实现请参考 AIsa Verity。
| API | 成本 |
|---|---|
| 网页搜索 | ~$0.001 |
| 学术搜索 | ~$0.002 |
| 智能搜索 | ~$0.002 |
| Tavily 搜索 | ~$0.002 |
| 解释功能 | ~$0.003 |
每个响应都包含 usage.cost 和 usage.credits_remaining。
export AISA_API_KEY="你的密钥"完整端点文档请参见 API 参考。