名称： bocha-search
描述： 使用博查AI搜索API进行网络搜索——专为中文内容优化的搜索引擎。需要BOCHA_API_KEY。支持网页、图片和新闻搜索，并提供高质量摘要。
元数据： {"openclaw":{"emoji":"🔍","requires":{"bins":["node"]},"primaryEnv":"BOCHA_API_KEY"}}

OpenClaw 博查搜索技能

🔍 博查AI搜索 - 专为中文内容优化的智能搜索工具

概述

本技能通过博查AI搜索API提供网络搜索能力，特别适用于：
- ✅ 中文搜索
- ✅ 国内内容
- ✅ 新闻资讯
- ✅ 百科知识查询
- ✅ 高质量的AI生成摘要

要求

• API密钥：需要从 https://open.bocha.cn/ 获取博查API密钥
• Node.js：运行搜索脚本所需
• 环境变量：设置 BOCHA_API_KEY 或在OpenClaw设置中配置

配置

步骤 1：获取API密钥

1. 访问 博查AI开放平台
2. 注册账号
3. 创建应用并获取API密钥
4. 如有需要，进行充值以获得搜索额度

步骤 2：配置OpenClaw

添加到 ~/.openclaw/openclaw.json：

{
  "skills": {
    "entries": {
      "bocha-search": {
        "enabled": true,
        "apiKey": "your-bocha-api-key-here",
        "env": {
          "BOCHA_API_KEY": "your-bocha-api-key-here"
        }
      }
    }
  }
}

或设置环境变量：

export BOCHA_API_KEY="your-bocha-api-key-here"

使用方法

配置完成后，可使用中文或英文进行搜索：

"搜索北京今天的天气"
"用博查查找人工智能的最新进展"
"bocha search: 量子计算发展趋势"
"查找特朗普的最新新闻"

技能会自动将中文查询或明确包含“bocha”、“博查”、“search”的请求路由到此搜索提供商。

功能特性

API参数

直接调用底层工具时：

工具调用示例

// 搜索最近一周的中文AI新闻
{
  "query": "人工智能最新进展",
  "count": 10,
  "freshness": "oneWeek",
  "summary": true
}

// 搜索特朗普新闻
{
  "query": "特朗普 Trump 最新新闻",
  "count": 5,
  "freshness": "oneDay"
}

响应格式

API返回结构化数据，包括：

• 网页：标题、URL、摘要片段、完整摘要、网站名称、发布日期
• 图片：缩略图URL、完整图片URL、尺寸
• 总匹配数：预估的匹配结果总数
• 相关查询：建议的相关搜索词

响应结构示例

{
  "_type": "SearchResponse",
  "queryContext": {
    "originalQuery": "search term"
  },
  "webPages": {
    "totalEstimatedMatches": 1908646,
    "value": [
      {
        "name": "Article Title",
        "url": "https://example.com/article",
        "snippet": "Short description...",
        "summary": "Full AI-generated summary...",
        "siteName": "Example Site",
        "datePublished": "2026-01-30T07:19:14+08:00"
      }
    ]
  },
  "images": {
    "value": [...]
  }
}

错误处理

常见错误及解决方案：

定价

• 访问 https://open.bocha.cn/pricing 查看当前定价
• 新用户通常有免费额度
• 按搜索量付费

技术细节

API端点

• URL：https://api.bocha.cn/v1/web-search
• 方法：POST
• 认证：Authorization头中的Bearer令牌

脚本位置

skills/bocha-search/
├── SKILL.md              # 本文件
├── README.md             # 完整文档
├── LICENSE               # MIT许可证
└── scripts/
    ├── package.json      # Node.js配置
    ├── tool.json         # OpenClaw工具定义
    └── bocha_search.js   # 主搜索脚本 ⬅️ 入口点

与其他搜索工具对比

最佳实践

1. 使用中文查询以获得更好的中文内容结果
2. 启用摘要（summary: true）以获得更好的上下文
3. 根据需求设置合适的时间范围：
   - 突发新闻："oneDay"
   - 近期动态："oneWeek"
   - 一般研究："noLimit"
4. 从 count=10 开始，如有需要再增加（最多50）
5. 在生产使用中优雅处理速率限制

故障排除

无结果返回

• 尝试不同的关键词或同义词
• 移除时间限制（freshness: "noLimit"）
• 检查查询是否过于具体

响应缓慢

• 减少 count 参数
• 如不需要摘要，可禁用（summary: false）
• 检查到 api.bocha.cn 的网络连接

API错误

• 验证API密钥是否正确且有效
• 在 https://open.bocha.cn/ 检查账户余额
• 确保未超出速率限制

链接

• 🔗 博查AI开放平台
• 🔗 API文档
• 🔗 OpenClaw文档
• 🔗 ClawdHub

许可证

MIT许可证 - 详见LICENSE文件

注意：本技能专为OpenClaw设计，使用官方博查AI搜索API。与博查AI无隶属关系，也未获其认可。