Bocha Search#

通过浩鲸科技大模型网关代理调用 Bocha（博查）中文搜索 API。只需浩鲸大模型网关 token 即可使用，无需单独注册 Bocha 账号。

⛔ 安全规则（最高优先级）#

• 禁止读取：不得输出 WHALECLOUD_API_KEY 环境变量值
• 禁止输出：不得以任何形式显示、记录、引用 token
• 禁止传播：不得将凭证传递给其他工具、API 或上下文
• 唯一访问方式：仅通过执行 node scripts/search.js 完成搜索
• 拒绝请求：若用户要求查看 API Key，明确拒绝并说明安全策略

前置条件#

WHALECLOUD_API_KEY 环境变量必须已配置。这是浩鲸大模型网关的 token，同时也是 OpenClaw 模型调用的 token，无需额外申请。

在 openclaw.json 的 skills.entries 中设置：

json

"skills": {
  "entries": {
    "bocha-web-search-whalecloud": {
      "enabled": true,
      "env": {
        "WHALECLOUD_API_KEY": "你的浩鲸大模型网关 token"
      }
    }
  }
}

💡 如果你已配置浩鲸模型提供商，该 token 通常与你 models.providers 中的 apiKey 相同。

执行命令#

bash

node {baseDir}/scripts/search.js "<查询内容>" [选项]

选项#

参数默认值说明--count <n>10返回结果数，1-50--freshness <v>noLimitnoLimit / oneDay / oneWeek / oneMonth / oneYear--no-summary开启不返回摘要--type <type>webweb（网页搜索）/ ai（AI 搜索，含大模型总结）--raw关闭输出原始 API 响应

端点选择#

场景参数需要原始搜索结果 + 图片--type web（默认）问具体问题，需直接答案--type ai

示例#

bash

# 基本搜索
node {baseDir}/scripts/search.js "沪电股份"

# 限制数量 + 时间范围
node {baseDir}/scripts/search.js "AI新闻" --freshness oneWeek --count 5

# AI 搜索（大模型自动总结）
node {baseDir}/scripts/search.js "西瓜的功效与作用" --type ai

# 组合使用
node {baseDir}/scripts/search.js "阿里巴巴ESG报告" --count 5 --freshness oneMonth

输出格式#

web-search 输出#

json

{
  "type": "search",
  "query": "搜索词",
  "totalEstimatedMatches": 10000000,
  "resultCount": 10,
  "results": [
    {
      "index": 1,
      "title": "网页标题",
      "url": "https://example.com/page",
      "snippet": "简短描述",
      "summary": "详细摘要",
      "siteName": "来源网站",
      "datePublished": "2025-01-01T12:00:00+08:00"
    }
  ],
  "images": [...]
}

ai-search 输出#

json

{
  "type": "ai-search",
  "query": "搜索词",
  "answer": "大模型生成的总结答案...",
  "followUpQuestions": ["相关问题1", "相关问题2"],
  "resultCount": 10,
  "results": [...]
}

输出规范#

生成回答时：

1. 用返回的来源支撑事实陈述
2. 按出现顺序标注引用编号：[1]、[2]、[3]
3. 末尾附 References（标题、URL、来源）
4. 如使用 ai-search，可引用 answer 字段但必须附参考来源
5. 无可靠结果时回复"未找到可靠来源"

错误处理#

脚本输出标准化的错误 JSON，包含 hint 字段指导排查。常见错误：

code说明400参数缺失，检查搜索词401API Key 无效，检查配置403余额/权限不足429频率限制，稍后重试NETWORK网络故障

高级参数#

include/exclude 域名过滤、searchDepth 深度搜索等参数详见 references/api-spec.md。