Tools
Serper
By Google Serper plugin for OpenClaw.
Install
openclaw plugins install https://github.com/fanzhidongyzby/openclaw-serper.gitConfiguration Example
// 基础搜索
serper_search({ query: "Python 3.13 新特性" })
// 获取更多结果
serper_search({
query: "人工智能 最新进展",
num: 10
})
// 搜索英文内容
serper_search({
query: "AI agents best practices 2025",
gl: "us",
hl: "en"
})README
# OpenClaw Serper Plugin
Google Serper API 搜索插件，为 OpenClaw 提供强大的网页搜索和学术检索能力。
## 功能特性
✅ **网页搜索**：通过 Google Serper API 获取最新搜索结果
✅ **学术检索**：通过 Google Scholar API 查找论文和学术文献
✅ **智能结果**：返回标题、URL、摘要等结构化信息
✅ **学术详情**：包含作者、年份、引用次数、发表刊物等详细信息
✅ **多语言支持**：支持中文、英文等多语言搜索
✅ **灵活配置**：可自定义结果数量、地区、语言
✅ **Skill 集成**：提供智能搜索 skill，自动识别搜索意图
## 安装
安装 serper 插件。
```bash
openclaw plugins install https://github.com/fanzhidongyzby/openclaw-serper.git
```
重启 Gateway：
```bash
openclaw gateway restart
```
确认 serper 插件为 `loaded` 状态。
```
openclaw plugins list
```
## 配置
### 1. 获取 Serper API Key
访问 [https://serper.dev/](https://serper.dev/) 注册并获取 API Key。
### 2. 配置环境变量
编辑 `~/.openclaw/.env`：
```bash
SERPER_API_KEY=your-api-key-here
```
### 3. 重启 Gateway
```bash
openclaw gateway restart
```
## 使用方式
### 工具调用
OpenClaw 会自动识别搜索需求并调用相应工具：
**网页搜索：**
```
你：帮我搜索最新的 AI 发展趋势
AI：[自动调用 serper_search]
```
**学术检索：**
```
你：搜索 Transformer 架构的相关论文
AI：[自动调用 serper_scholar]
```
### Skill 场景
**serper-search skill 会在以下场景自动激活：**
- 🔍 **搜索查询**："搜索"、"查找"、"研究"
- 📰 **新闻获取**："今天有什么新闻"
- 🔬 **技术调研**："研究一下 LangChain"
- ✅ **事实验证**："查查这个说法是否正确"
**serper-scholar skill 会在以下场景自动激活：**
- 📚 **学术搜索**："论文"、"文献"、"学术研究"
- 🎓 **论文查找**："搜索关于...的论文"
- 🔬 **领域调研**："查找...的研究进展"
- 👨🔬 **作者研究**："查找...的论文"
## 参数说明
### serper_search（网页搜索）
| 参数 | 类型 | 必选 | 默认值 | 说明 |
|------|------|------|--------|------|
| query | string | ✅ | - | 搜索关键词 |
| num | number | ❌ | 5 | 结果数量（最大 20） |
| gl | string | ❌ | cn | 国家代码（cn, us, uk, etc.） |
| hl | string | ❌ | zh-CN | 语言代码（zh-CN, en, etc.） |
### serper_scholar（学术检索）
| 参数 | 类型 | 必选 | 默认值 | 说明 |
|------|------|------|--------|------|
| query | string | ✅ | - | 搜索关键词 |
| num | number | ❌ | 10 | 结果数量（最大 20） |
| gl | string | ❌ | cn | 国家代码（cn, us, uk, etc.） |
| hl | string | ❌ | zh-CN | 语言代码（zh-CN, en, etc.） |
**返回额外字段：**
- `authors`：作者列表
- `year`：发表年份
- `citationCount`：引用次数
- `publication`：发表刊物/会议
- `type`：文献类型（PDF、HTML 等）
## 示例
### 网页搜索
```javascript
// 基础搜索
serper_search({ query: "Python 3.13 新特性" })
// 获取更多结果
serper_search({
query: "人工智能 最新进展",
num: 10
})
// 搜索英文内容
serper_search({
query: "AI agents best practices 2025",
gl: "us",
hl: "en"
})
```
### 学术检索
```javascript
// 搜索学术论文
serper_scholar({
query: "Transformer architecture attention",
num: 5
})
// 搜索特定领域
serper_scholar({
query: "Reinforcement learning robotics",
num: 10,
gl: "us",
hl: "en"
})
// 搜索中文学术文献
serper_scholar({
query: "大语言模型 微调",
gl: "cn",
hl: "zh-CN"
})
```
## 目录结构
```
extensions/serper/
├── index.ts # 插件入口，注册两个工具
├── openclaw.plugin.json # 插件元数据
├── package.json # npm 包配置
├── README.md # 本文档
├── LICENSE # MIT 许可证
├── .gitignore # Git 忽略文件
└── skills/
├── serper-search/ # 网页搜索 skill
│ └── SKILL.md
└── serper-scholar/ # 学术检索 skill
└── SKILL.md
```
## 工具对比
| 特性 | serper_search | serper_scholar |
|------|---------------|----------------|
| **用途** | 网页搜索 | 学术检索 |
| **端点** | `/search` | `/scholar` |
| **返回信息** | 标题、链接、摘要 | + 作者、年份、引用、刊物 |
| **适用场景** | 快速信息查询 | 深度学术研究 |
| **知识图谱** | ✅ 支持 | ❌ 不支持 |
| **结果数量默认** | 5 | 10 |
## 开发与贡献
欢迎提交 Issue 和 Pull Request！
## 许可证
MIT License
## 相关链接
- [Serper 官网](https://serper.dev/)
- [OpenClaw 文档](https://docs.openclaw.ai/)
- [ClawHub](https://clawhub.com/)
---
**Made with ❤️ for OpenClaw Community**
tools
Comments
Sign in to leave a comment