OpenClaw的博查搜索技能

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

概述

此技能通过博查AI搜索API提供网络搜索能力。它特别适用于：

• ✅ 中文语言搜索
• ✅ 国内中文内容
• ✅ 新闻资讯与实时事件
• ✅ 百科知识与查询
• ✅ 高质量的AI生成摘要

要求

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

或通过OpenClaw设置进行配置

步骤一：获取API密钥

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

步骤二：配置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"请求路由到此搜索提供商。

功能特色

直接调用底层工具时：

参数

工具调用示例

// Search for recent AI news in Chinese
{
  "query": "人工智能最新进展",
  "count": 10,
  "freshness": "oneWeek",
  "summary": true
}

// Search for Trump news
{
  "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 token

脚本位置

skills/bocha-search/
├── SKILL.md              # This file
├── README.md             # Full documentation
├── LICENSE               # MIT License
└── scripts/
    ├── package.json      # Node.js config
    ├── tool.json         # OpenClaw tool definition
    └── bocha_search.js   # Main search script ⬅️ Entry point

与其他搜索工具的比较

最佳实践

1. 使用中文查询以获得更好的中文内容结果
2. 启用摘要(summary: true) 以获得更好的上下文
3. 根据您的需求设置适当的新鲜度：突发新闻：
   • "oneDay"近期动态：
   • "oneWeek"一般研究：
   • "noLimit"从 count=10 开始
4. Start with count=10，根据需要增加（最大50）
5. 优雅处理速率限制在生产环境中使用

故障排除

未返回结果

• 尝试不同的关键词或同义词
• 移除时间限制（新鲜度："无限制"）
• 检查您的查询是否过于具体

响应缓慢

• 减少数量参数
• 如果不需要，请禁用摘要（摘要：false）
• 检查与api.bocha.cn

的网络连接

• API错误
• 验证API密钥是否正确且有效在
• https://open.bocha.cn/

链接

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

许可证

MIT许可证 - 详情请参阅LICENSE文件

注意：此技能专为OpenClaw设计，并使用官方的博查AI搜索API。它并非由博查AI开发或背书。