Serper Clone 技能

使用自托管的 Serper 兼容 API 进行网络搜索。以 SearXNG 作为搜索后端，通过轻量级桥接层暴露熟悉的 Serper API 格式。

为什么选择自托管搜索？

• - 免费且无限制 — 无 API 配额，无按次查询费用
• 私密 — 查询永远不会离开你的基础设施
• 无速率限制 — 按需搜索，不受限制
• 即插即用兼容 — 与 serper.dev 相同的 API 格式

设置

1. 部署 Serper Clone 实例

你需要一个正在运行的 Serper Clone API 实例。选项：

• - StartOS（推荐用于家庭服务器）： 从 serper-startos 安装
• Docker： 查看 serper-startos 的 README 了解 Docker 部署方式
• 任何暴露 Serper 兼容 API 的 SearXNG + 桥接设置

部署后，记录你的：

• - 基础 URL（例如 https://search.example.com 或 http://192.168.1.50:8080）
• API 密钥（在设置过程中配置）

2. 配置技能

创建 API 密钥文件：

bash
echo API_KEY=你的-api-密钥 > ~/.openclaw/workspace/.serper-clone-api-key
echo BASE_URL=https://你的-serper-clone-主机 >> ~/.openclaw/workspace/.serper-clone-api-key
chmod 600 ~/.openclaw/workspace/.serper-clone-api-key

该文件存在之前，技能不会激活。

端点

所有端点均接受带有 JSON 主体的 POST 请求。

使用方法

读取配置

bash
APIKEY=$(grep ^APIKEY= ~/.openclaw/workspace/.serper-clone-api-key | cut -d= -f2)
BASEURL=$(grep ^BASEURL= ~/.openclaw/workspace/.serper-clone-api-key | cut -d= -f2)

网络搜索

bash
curl -s -X POST $BASE_URL/search \
-H X-API-KEY: $API_KEY \
-H Content-Type: application/json \
-d {q: 搜索查询, num: 10} | jq .

搜索参数

json
{
q: 搜索查询, // 必填：搜索词
gl: us, // 国家代码
hl: en, // 语言代码
num: 10, // 结果数量（1-100）
page: 1, // 结果页码
autocorrect: true, // 启用/禁用拼写纠正
location: 奥斯汀, 德克萨斯州 // 位置提示
}

响应格式

json
{
searchParameters: { q: ..., gl: us, hl: en, num: 10 },
organic: [
{
title: 结果标题,
link: https://example.com,
snippet: 结果描述...,
position: 1,
date: 2026-02-16T00:00:00
}
],
answerBox: { answer: ..., snippet: ... },
relatedSearches: [ { query: 相关搜索 } ],
credits: 0
}

新闻搜索

bash
curl -s -X POST $BASE_URL/news \
-H X-API-KEY: $API_KEY \
-H Content-Type: application/json \
-d {q: 最新AI新闻, num: 5}

图片搜索

bash
curl -s -X POST $BASE_URL/images \
-H X-API-KEY: $API_KEY \
-H Content-Type: application/json \
-d {q: 神经网络架构图}

学术文章

bash
curl -s -X POST $BASE_URL/scholar \
-H X-API-KEY: $API_KEY \
-H Content-Type: application/json \
-d {q: 混合专家Transformer, num: 10}

辅助函数

为方便在 shell 脚本中使用：

bash
serper_search() {
local endpoint=${1:-search}
local query=$2
local num=${3:-10}
local apikey=$(grep ^APIKEY= ~/.openclaw/workspace/.serper-clone-api-key | cut -d= -f2)
local baseurl=$(grep ^BASEURL= ~/.openclaw/workspace/.serper-clone-api-key | cut -d= -f2)

curl -s -X POST $base_url/$endpoint \
-H X-API-KEY: $api_key \
-H Content-Type: application/json \
-d {\q\: \$query\, \num\: $num}
}

示例：

serper_search search OpenClaw 智能体框架 10

serper_search news 2026年AI发布 5

serper_search scholar 大型语言模型 10

安全说明

• - API 密钥文件应设置为 chmod 600（仅所有者可读）
• 所有请求仅在 OpenClaw 实例和 Serper Clone 实例之间传输
• 不会向任何第三方服务发送数据
• 技能仅在 API 密钥文件存在时激活

相关资源

• - Serper Clone 服务器： github.com/paulscode/serper-startos
• SearXNG： github.com/searxng/searxng — 搜索后端