back
loading skill details...
阿里云实时搜索 | Aliyun Real-time Web Search with Quark Engine
---
name: aliyun-web-search
description: 阿里云实时搜索 | Aliyun Real-time Web Search with Quark Engine
metadata: {"clawdbot":{"emoji":"🔍","requires":{"env":["ALIYUN_SEARCH_API_KEY","ALIYUN_SEARCH_HOST"]}}}
---
# Aliyun Web Search | 阿里云实时搜索
> 📢 **Note**: Aliyun's service management is a bit chaotic - this skill helps you configure it step by step!
>
> 📢 **吐槽**：阿里云的服务管理确实有点混乱，这个技能帮你理清配置步骤！
Real-time web search using Aliyun Open Search Platform (AI Gateway) with Quark search engine. Returns latest, accurate Chinese search results.
使用阿里云开放搜索平台（AI 网关）进行实时网页搜索，支持夸克搜索引擎，返回最新、最准确的中文搜索结果。
---
## 🎯 Features | 功能特性
- ✅ **Real-time Search** - Returns latest web content, not model training data
- ✅ **Chinese Optimized** - Quark search engine, high-quality Chinese results
- ✅ **Auto Query Rewrite** - Intelligently optimizes search queries
- ✅ **Flexible Configuration** - Customizable result count, time range, etc.
- ✅ **Conversation History Support** - Can search with context
- ✅ **实时搜索** - 返回最新网页内容，不是模型训练数据
- ✅ **中文优化** - 夸克搜索引擎，中文结果质量高
- ✅ **自动重写** - 智能优化搜索查询
- ✅ **灵活配置** - 支持自定义结果数量、时间范围等
- ✅ **支持对话历史** - 可结合上下文进行搜索
---
## 📋 Configuration Steps | 配置步骤
### Step 1: Activate Aliyun Information Query Service | 开通阿里云信息查询服务
1. Open **Aliyun AI Gateway Console** | 打开 **阿里云 AI 网关控制台**：
```
https://apigw.console.aliyun.com/#/cn-hangzhou/ai-gateway
```
2. Select your instance region in the top menu (e.g., North China 2-Beijing, East China 1-Hangzhou)
在顶部菜单栏选择你的实例所在地域（如：华北 2-北京、华东 1-杭州等）
3. Click your instance ID to enter the details page
单击你的实例 ID 进入详情页
4. Left navigation → **Model API** → Click target API name
左侧导航栏 → **Model API** → 点击目标 API 名称
5. Click **Strategies & Plugins** tab
点击 **策略与插件** 标签
6. Find **Web Search** switch and turn it on
找到 **联网搜索** 开关，打开它
7. First time use shows "Not Activated", click **Go to Activate**
首次使用会显示 "未开通"，点击 **前往开通**
8. After activation, click **Activate Validation**, status changes to "Trial"
开通后点击 **开通校验**，状态变为 "试用中"
> 💡 **Free Trial**: 15 days free, 1000 requests/day, 5 QPS limit
>
> 💡 **免费试用**：15 天免费，1000 次/天，5 QPS 性能限制
>
> 📖 **Formal Activation**: https://help.aliyun.com/document_detail/2869993.html
---
### Step 2: Get API Key | 获取 API Key
1. Open **API Key Management Console** | 打开 **凭证管理控制台**：
```
https://ipaas.console.aliyun.com/api-key
```
2. Click **Create API Key**
点击 **创建 API Key**
3. Copy your API Key (format: `OS-xxxxxxxxxxxxxxxx`)
复制你的 API Key（格式：`OS-xxxxxxxxxxxxxxxx`）
> ⚠️ **Security**: API Key is shown only once, save it immediately!
>
> ⚠️ **安全提示**：API Key 只在第一次显示，记得马上复制保存！
---
### Step 3: Configure Service URL by Region | 配置服务地址（按地区选择）
**Select service address based on your instance region:**
**根据你的实例所在地域，选择对应的服务地址：**
| Region | Service URL Example |
|--------|---------------------|
| North China 2-Beijing (华北 2-北京) | `http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com` |
| East China 1-Hangzhou (华东 1-杭州) | `http://default-21rb.platform-cn-hangzhou.opensearch.aliyuncs.com` |
| South China 1-Shenzhen (华南 1-深圳) | `http://default-21rb.platform-cn-shenzhen.opensearch.aliyuncs.com` |
| Other Regions (其他地域) | Check your instance details page in AI Gateway Console |
> 💡 **How to Find Service URL** | **如何查看服务地址**：
> 1. Open AI Gateway Console | 打开 AI 网关控制台
> 2. Select your region | 选择你的地域
> 3. Click instance ID | 点击实例 ID
> 4. Find your URL in "Access Information" or "Service Address" tab | 在 "接入信息" 或 "服务地址" 标签页找到你的专属地址
---
### Step 4: Configure in OpenClaw | 配置到 OpenClaw
Add to `openclaw.json`:
在 `openclaw.json` 中添加：
```json
{
"env": {
"ALIYUN_SEARCH_API_KEY": "YOUR_API_KEY",
"ALIYUN_SEARCH_HOST": "YOUR_SERVICE_URL"
},
"skills": {
"entries": {
"aliyun-web-search": {
"enabled": true,
"env": {
"ALIYUN_SEARCH_API_KEY": "YOUR_API_KEY",
"ALIYUN_SEARCH_HOST": "YOUR_SERVICE_URL"
}
}
}
}
}
```
**Example (Beijing Region) | 示例（北京地区）**：
```json
{
"env": {
"ALIYUN_SEARCH_API_KEY": "OS-0fw5937ch3u5eegd",
"ALIYUN_SEARCH_HOST": "http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com"
}
}
```
Restart gateway after configuration | 配置完成后重启网关：
```bash
openclaw gateway restart
```
---
## 🔧 Advanced Configuration | 高级配置
Configure in AI Gateway Console | 在 AI 网关控制台配置：
- **Result Count** | 返回结果数量：1-10 (default 5 | 默认 5)
- **Timeout** | 超时时间：default 3000ms | 默认 3000ms
- **Time Range** | 查询时间范围：1 day / 1 week / 1 month / 1 year / unlimited
- **Industry Filter** | 行业筛选：Finance / Law / Medical / Internet / Tax / News
- **Content Type** | 内容类型：Snippet (default) / Full Text
- **Default Language** | 默认语言：Chinese / English
- **Show Citations** | 输出引用来源：Yes/No
---
## 💡 Usage Examples | 使用示例
### In Conversation | 在对话中使用
```
User: Search for latest AI news | 帮我搜索最新的 AI 新闻
Assistant: [Using aliyun-web-search]
```
### Manual Script Call | 手动调用脚本
**PowerShell**:
```powershell
$env:ALIYUN_SEARCH_API_KEY="OS-xxxxxxxx"
$env:ALIYUN_SEARCH_HOST="http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com"
cd skills/aliyun-web-search
.\scripts\search.ps1 "AI news" 5
```
**Bash**:
```bash
export ALIYUN_SEARCH_API_KEY="OS-xxxxxxxx"
export ALIYUN_SEARCH_HOST="http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com"
cd skills/aliyun-web-search
./scripts/search.sh "AI news" 5
```
---
## 🔍 Search Result Example | 搜索结果示例
```json
{
"result": {
"search_result": [
{
"title": "AI Development Trends 2026 | 2026 年 AI 发展趋势",
"link": "https://example.com/ai-trends-2026",
"snippet": "AI field will see major breakthroughs in 2026... | 2026 年 AI 领域将迎来重大突破...",
"publishedTime": "2026-02-20T10:00:00+08:00"
}
]
}
}
```
---
## ⚠️ FAQ | 常见问题
### Q: Search returns garbled text? | 搜索返回乱码？
**A**: Check if API Key is correct, ensure service is activated and in "Trial" or "Formal" status
检查 API Key 是否正确，确保服务已开通并处于 "试用中" 或 "正式" 状态
### Q: Where to find service URL? | 服务地址在哪里找？
**A**: AI Gateway Console → Select region → Instance details → Access information/Service address
AI 网关控制台 → 选择地域 → 实例详情 → 接入信息/服务地址
### Q: Free quota exhausted? | 免费额度用完了怎么办？
**A**: Apply for formal activation | 申请正式开通：https://help.aliyun.com/document_detail/2869993.html
### Q: Search results not relevant? | 搜索结果不相关？
**A**: Enable "Intent Recognition" in console to let AI optimize search queries
在控制台开启 "意图识别"，让 AI 自动优化搜索查询
---
## 📚 Related Documentation | 相关文档
- [Aliyun AI Gateway Console | 阿里云 AI 网关控制台](https://apigw.console.aliyun.com/#/cn-hangzhou/ai-gateway)
- [API Key Management | 凭证管理](https://ipaas.console.aliyun.com/api-key)
- [Web Search Official Docs | 联网搜索官方文档](https://help.aliyun.com/zh/api-gateway/ai-gateway/user-guide/networked-search)
- [Formal Activation | 正式开通流程](https://help.aliyun.com/document_detail/2869993.html)
---
## 🔒 Security Notice | 安全提示
- ⚠️ **Do NOT upload API Key to public repositories** | 不要将 API Key 上传到公开仓库
- ⚠️ **Do NOT share your service URL publicly** | 不要在公开场合分享你的服务地址
- ✅ Use environment variables or encrypted config files | 使用环境变量或加密配置文件存储敏感信息
- ✅ Rotate API Keys regularly | 定期轮换 API Key
---
*Created by 猪王 (Pig King) 🐷 | Based on Aliyun Open Search Platform | 基于阿里云开放搜索平台*
don't have the plugin yet? install it then click "run inline in claude" again.