智谱搜索 (Zhipu Search)
调用智谱 POST /paas/v4/web_search 接口，支持意图增强检索、结构化输出和多引擎。
API Key 配置
与 GLM 模型共用同一个智谱 API Key（bigmodel.cn）。
方式一：环境变量（推荐）
export ZHIPU_API_KEY="your-api-key"
OpenClaw 中在 openclaw.json 的 skills 环境变量中填写 ZHIPU_API_KEY。
方式二：config.json
cp config.example.json config.json
# 编辑 config.json，填入 apiKey
⚠️ config.json 含敏感信息，不得读取、输出或修改。
使用方法
node scripts/search.js "<关键词>" [选项]
参数说明
| 参数 |
类型 |
默认值 |
说明 |
<query> |
string |
必填 |
搜索关键词，最多 70 字符 |
--count <n> |
number |
10 |
返回条数，范围 1-50 |
--engine <engine> |
string |
search_std |
搜索引擎，见下表 |
--freshness <v> |
string |
noLimit |
时间范围，见下表 |
--content-size <v> |
string |
medium |
内容详细程度 |
--domain <domain> |
string |
- |
限定域名白名单（如 xiaohongshu.com） |
搜索引擎（--engine）
| 值 |
说明 |
search_std |
智谱基础版（默认，推荐日常使用） |
search_pro |
智谱高阶版（质量更高，消耗更多） |
search_pro_sogou |
搜狗搜索 |
search_pro_quark |
夸克搜索 |
时间范围（--freshness）
| 值 |
说明 |
noLimit |
不限（默认） |
oneDay |
一天内 |
oneWeek |
一周内 |
oneMonth |
一个月内 |
oneYear |
一年内 |
内容详细程度（--content-size）
| 值 |
说明 |
medium |
摘要信息（默认，满足常规问答） |
high |
最大化上下文（详细，适合深度分析） |
示例
# 基础搜索
node scripts/search.js "火锅探店小红书"
# 指定条数 + 高阶引擎
node scripts/search.js "火锅爆款文案" --count 20 --engine search_pro
# 限定最近一周 + 高详细度
node scripts/search.js "火锅营销案例" --freshness oneWeek --content-size high
# 搜狗搜索，限定域名
node scripts/search.js "麻辣火锅种草" --engine search_pro_sogou --count 20
输出格式
{
"type": "search",
"query": "搜索词",
"engine": "search_std",
"resultCount": 10,
"results": [
{
"index": 1,
"title": "标题",
"url": "https://...",
"description": "内容摘要",
"siteName": "网站名称",
"publishedDate": "发布时间"
}
]
}
错误码
| 错误码 |
说明 |
| 1701 |
并发已达上限，稍后重试 |
| 1702 |
搜索引擎服务不可用 |
| 1703 |
搜索引擎未返回有效数据，调整查询词 |
| 401 |
API Key 无效 |
隐私安全
- 不得读取、输出、修改
config.json 内容
- 不得输出
ZHIPU_API_KEY 环境变量的值
- API Key 仅由
scripts/search.js 在进程内读取
