openclaw-web-search

openclaw-web-search 是 OpenClaw 的独立外部插件，用来补齐 OpenClaw 默认缺少国产大模型联网搜索能力的问题。

这个项目的目标很直接：把国产搜索 Provider 做成可安装、可配置、可发布的独立插件，让 OpenClaw 能更方便地接入千问、豆包、秘塔、智普等国产搜索线路。

为什么需要这个插件

这个插件不属于 OpenClaw 主仓库内置 extensions/*，而是作为外部插件发布：

• npm 包名：@ww-ai-lab/openclaw-web-search
• 插件 ID：openclaw-web-search
• 发布方式：openclaw plugins install @ww-ai-lab/openclaw-web-search
• 许可证：MIT

它要解决的问题是：

• OpenClaw 默认没有开箱即用的国产大模型搜索适配。
• 不同国产搜索服务的协议、鉴权方式、返回结构并不一致。
• 需要一个独立插件，把这些差异统一收敛到 OpenClaw 的 web_search Provider 接口中。
• 插件独立发布后，可以不依赖 OpenClaw 主仓库发版节奏，逐步增加新的国产搜索 Provider。

已支持与规划中的 Provider

路线图

本项目按“先打通一条稳定可用线路，再逐步扩展国产搜索 Provider”的方式推进：

1. 第一阶段：完成 Qwen（DashScope 原生协议）接入，验证插件配置、缓存、错误处理、引用输出、npm 发布链路。
2. 第二阶段：增加豆包 / ARK 搜索适配，统一配置结构与凭据解析链。
3. 第三阶段：增加秘塔搜索与智普搜索，补充更多响应归一化测试。
4. 第四阶段：抽象更多共享基础设施，兼容更多可接入的搜索服务。
5. 第五阶段：完善 Provider 选择策略、文档、示例与自动化发布流程。

安装说明

前置要求

方式一：从 npm 安装

openclaw plugins install @ww-ai-lab/openclaw-web-search
openclaw plugins enable openclaw-web-search
openclaw gateway restart

方式二：从源码本地安装

git clone git@github.com:WW-AI-Lab/openclaw-web-search.git
cd openclaw-web-search
npm install

# 在 OpenClaw 主目录执行
openclaw plugins install -l /path/to/openclaw-web-search
openclaw plugins enable openclaw-web-search
openclaw gateway restart

安装后检查

如果 OpenClaw 已正确加载插件，应能在插件列表中看到 openclaw-web-search，并在配置中看到 qwen 相关字段。

配置说明

当前已实现的是 Qwen（DashScope 原生协议）线路，支持三种配置方式。

方式一：插件配置，推荐

{
  plugins: {
    entries: {
      "openclaw-web-search": {
        enabled: true,
        config: {
          qwen: {
            apiKey: "sk-...",
            model: "qwen-plus",
            searchStrategy: "turbo",
            forcedSearch: false,
            enableThinking: false,
            enableSearchExtension: false,
            enableSource: true,
            enableCitation: false,
            citationFormat: "[<number>]",
            freshness: 30,
            timeoutSeconds: 30
          }
        }
      }
    }
  }
}

方式二：兼容旧式搜索配置

{
  tools: {
    web: {
      search: {
        qwen: {
          apiKey: "sk-..."
        }
      }
    }
  }
}

方式三：环境变量

export DASHSCOPE_API_KEY="sk-..."

凭据优先级从高到低如下：

1. plugins.entries.openclaw-web-search.config.qwen.apiKey
2. tools.web.search.qwen.apiKey
3. DASHSCOPE_API_KEY

Qwen 配置项说明

支持的 Qwen 模型

默认模型为 qwen-plus。你也可以按 DashScope 平台实际支持情况切换到其他联网模型，例如：

• qwen3-max
• qwen-max-latest
• qwen3.5-plus
• qwen-plus-latest
• qwen3.5-flash
• qwen-turbo
• qwq-plus
• deepseek-v3.2
• deepseek-r1

插件不会对模型名做强校验，以便兼容 DashScope 后续新增的模型。

开发与验证

npm install
npm run check
npm test

开发文档

• AI 开发指引（AGENTS.md）
• 变更日志（CHANGELOG.md）

提示：docs/ 与 openspec/ 目录默认作为本地工作资料保留，不参与当前 Git 发布内容。

许可证

本项目基于 MIT 协议发布。