Aliyun Web Search | 阿里云实时搜索

📢 Note: Aliyuns 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. 1. Open Aliyun AI Gateway Console | 打开 阿里云 AI 网关控制台：

https://apigw.console.aliyun.com/#/cn-hangzhou/ai-gateway

1. 2. Select your instance region in the top menu (e.g., North China 2-Beijing, East China 1-Hangzhou)

在顶部菜单栏选择你的实例所在地域（如：华北 2-北京、华东 1-杭州等）

1. 3. Click your instance ID to enter the details page

单击你的实例 ID 进入详情页

1. 4. Left navigation → Model API → Click target API name

左侧导航栏 → Model API → 点击目标 API 名称

1. 5. Click Strategies & Plugins tab

点击 策略与插件 标签

1. 6. Find Web Search switch and turn it on

找到 联网搜索 开关，打开它

1. 7. First time use shows Not Activated, click Go to Activate

首次使用会显示 未开通，点击 前往开通

1. 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. 1. Open API Key Management Console | 打开 凭证管理控制台：

https://ipaas.console.aliyun.com/api-key

1. 2. Click Create API Key

点击 创建 API Key

1. 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:

根据你的实例所在地域，选择对应的服务地址：

💡 How to Find Service URL | 如何查看服务地址：

1. 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: {
ALIYUNSEARCHAPIKEY: YOURAPI_KEY,
ALIYUNSEARCHHOST: YOURSERVICEURL
},
skills: {
entries: {
aliyun-web-search: {
enabled: true,
env: {
ALIYUNSEARCHAPIKEY: YOURAPI_KEY,
ALIYUNSEARCHHOST: YOURSERVICEURL
}
}
}
}
}

Example (Beijing Region) | 示例（北京地区）：
json
{
env: {
ALIYUNSEARCHAPI_KEY: OS-0fw5937ch3u5eegd,
ALIYUNSEARCHHOST: 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:ALIYUNSEARCHAPI_KEY=OS-xxxxxxxx
$env:ALIYUNSEARCHHOST=http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com
cd skills/aliyun-web-search
.\scripts\search.ps1 AI news 5

Bash:
bash
export ALIYUNSEARCHAPI_KEY=OS-xxxxxxxx
export ALIYUNSEARCHHOST=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? | 搜索返回乱码？

Q: Where to find service URL? | 服务地址在哪里