{
  "schemaVersion": "1.0",
  "item": {
    "slug": "aliyun-web-search",
    "name": "Aliyun Web Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/xiaoyunbowen/aliyun-web-search",
    "canonicalUrl": "https://clawhub.ai/xiaoyunbowen/aliyun-web-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/aliyun-web-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aliyun-web-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "scripts/search.sh",
      "SKILL.md",
      "_meta.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/aliyun-web-search"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/aliyun-web-search",
    "agentPageUrl": "https://openagent3.xyz/skills/aliyun-web-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aliyun-web-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aliyun-web-search/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Aliyun Web Search | 阿里云实时搜索",
        "body": "📢 Note: Aliyun's service management is a bit chaotic - this skill helps you configure it step by step!\n📢 吐槽：阿里云的服务管理确实有点混乱，这个技能帮你理清配置步骤！\n\nReal-time web search using Aliyun Open Search Platform (AI Gateway) with Quark search engine. Returns latest, accurate Chinese search results.\n\n使用阿里云开放搜索平台（AI 网关）进行实时网页搜索，支持夸克搜索引擎，返回最新、最准确的中文搜索结果。"
      },
      {
        "title": "🎯 Features | 功能特性",
        "body": "✅ Real-time Search - Returns latest web content, not model training data\n\n\n✅ Chinese Optimized - Quark search engine, high-quality Chinese results\n\n\n✅ Auto Query Rewrite - Intelligently optimizes search queries\n\n\n✅ Flexible Configuration - Customizable result count, time range, etc.\n\n\n✅ Conversation History Support - Can search with context\n\n\n✅ 实时搜索 - 返回最新网页内容，不是模型训练数据\n\n\n✅ 中文优化 - 夸克搜索引擎，中文结果质量高\n\n\n✅ 自动重写 - 智能优化搜索查询\n\n\n✅ 灵活配置 - 支持自定义结果数量、时间范围等\n\n\n✅ 支持对话历史 - 可结合上下文进行搜索"
      },
      {
        "title": "Step 1: Activate Aliyun Information Query Service | 开通阿里云信息查询服务",
        "body": "Open Aliyun AI Gateway Console | 打开 阿里云 AI 网关控制台：\nhttps://apigw.console.aliyun.com/#/cn-hangzhou/ai-gateway\n\n\n\nSelect your instance region in the top menu (e.g., North China 2-Beijing, East China 1-Hangzhou)\n在顶部菜单栏选择你的实例所在地域（如：华北 2-北京、华东 1-杭州等）\n\n\nClick your instance ID to enter the details page\n单击你的实例 ID 进入详情页\n\n\nLeft navigation → Model API → Click target API name\n左侧导航栏 → Model API → 点击目标 API 名称\n\n\nClick Strategies & Plugins tab\n点击 策略与插件 标签\n\n\nFind Web Search switch and turn it on\n找到 联网搜索 开关，打开它\n\n\nFirst time use shows \"Not Activated\", click Go to Activate\n首次使用会显示 \"未开通\"，点击 前往开通\n\n\nAfter activation, click Activate Validation, status changes to \"Trial\"\n开通后点击 开通校验，状态变为 \"试用中\"\n\n💡 Free Trial: 15 days free, 1000 requests/day, 5 QPS limit\n💡 免费试用：15 天免费，1000 次/天，5 QPS 性能限制\n📖 Formal Activation: https://help.aliyun.com/document_detail/2869993.html"
      },
      {
        "title": "Step 2: Get API Key | 获取 API Key",
        "body": "Open API Key Management Console | 打开 凭证管理控制台：\nhttps://ipaas.console.aliyun.com/api-key\n\n\n\nClick Create API Key\n点击 创建 API Key\n\n\nCopy your API Key (format: OS-xxxxxxxxxxxxxxxx)\n复制你的 API Key（格式：OS-xxxxxxxxxxxxxxxx）\n\n⚠️ Security: API Key is shown only once, save it immediately!\n⚠️ 安全提示：API Key 只在第一次显示，记得马上复制保存！"
      },
      {
        "title": "Step 3: Configure Service URL by Region | 配置服务地址（按地区选择）",
        "body": "Select service address based on your instance region:\n\n根据你的实例所在地域，选择对应的服务地址：\n\nRegionService URL ExampleNorth China 2-Beijing (华北 2-北京)http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.comEast China 1-Hangzhou (华东 1-杭州)http://default-21rb.platform-cn-hangzhou.opensearch.aliyuncs.comSouth China 1-Shenzhen (华南 1-深圳)http://default-21rb.platform-cn-shenzhen.opensearch.aliyuncs.comOther Regions (其他地域)Check your instance details page in AI Gateway Console\n\n💡 How to Find Service URL | 如何查看服务地址：\n\nOpen AI Gateway Console | 打开 AI 网关控制台\nSelect your region | 选择你的地域\nClick instance ID | 点击实例 ID\nFind your URL in \"Access Information\" or \"Service Address\" tab | 在 \"接入信息\" 或 \"服务地址\" 标签页找到你的专属地址"
      },
      {
        "title": "Step 4: Configure in OpenClaw | 配置到 OpenClaw",
        "body": "Add to openclaw.json:\n\n在 openclaw.json 中添加：\n\n{\n  \"env\": {\n    \"ALIYUN_SEARCH_API_KEY\": \"YOUR_API_KEY\",\n    \"ALIYUN_SEARCH_HOST\": \"YOUR_SERVICE_URL\"\n  },\n  \"skills\": {\n    \"entries\": {\n      \"aliyun-web-search\": {\n        \"enabled\": true,\n        \"env\": {\n          \"ALIYUN_SEARCH_API_KEY\": \"YOUR_API_KEY\",\n          \"ALIYUN_SEARCH_HOST\": \"YOUR_SERVICE_URL\"\n        }\n      }\n    }\n  }\n}\n\nExample (Beijing Region) | 示例（北京地区）：\n\n{\n  \"env\": {\n    \"ALIYUN_SEARCH_API_KEY\": \"OS-0fw5937ch3u5eegd\",\n    \"ALIYUN_SEARCH_HOST\": \"http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com\"\n  }\n}\n\nRestart gateway after configuration | 配置完成后重启网关：\n\nopenclaw gateway restart"
      },
      {
        "title": "🔧 Advanced Configuration | 高级配置",
        "body": "Configure in AI Gateway Console | 在 AI 网关控制台配置：\n\nResult Count | 返回结果数量：1-10 (default 5 | 默认 5)\nTimeout | 超时时间：default 3000ms | 默认 3000ms\nTime Range | 查询时间范围：1 day / 1 week / 1 month / 1 year / unlimited\nIndustry Filter | 行业筛选：Finance / Law / Medical / Internet / Tax / News\nContent Type | 内容类型：Snippet (default) / Full Text\nDefault Language | 默认语言：Chinese / English\nShow Citations | 输出引用来源：Yes/No"
      },
      {
        "title": "In Conversation | 在对话中使用",
        "body": "User: Search for latest AI news | 帮我搜索最新的 AI 新闻\nAssistant: [Using aliyun-web-search]"
      },
      {
        "title": "Manual Script Call | 手动调用脚本",
        "body": "PowerShell:\n\n$env:ALIYUN_SEARCH_API_KEY=\"OS-xxxxxxxx\"\n$env:ALIYUN_SEARCH_HOST=\"http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com\"\ncd skills/aliyun-web-search\n.\\scripts\\search.ps1 \"AI news\" 5\n\nBash:\n\nexport ALIYUN_SEARCH_API_KEY=\"OS-xxxxxxxx\"\nexport ALIYUN_SEARCH_HOST=\"http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com\"\ncd skills/aliyun-web-search\n./scripts/search.sh \"AI news\" 5"
      },
      {
        "title": "🔍 Search Result Example | 搜索结果示例",
        "body": "{\n  \"result\": {\n    \"search_result\": [\n      {\n        \"title\": \"AI Development Trends 2026 | 2026 年 AI 发展趋势\",\n        \"link\": \"https://example.com/ai-trends-2026\",\n        \"snippet\": \"AI field will see major breakthroughs in 2026... | 2026 年 AI 领域将迎来重大突破...\",\n        \"publishedTime\": \"2026-02-20T10:00:00+08:00\"\n      }\n    ]\n  }\n}"
      },
      {
        "title": "Q: Search returns garbled text? | 搜索返回乱码？",
        "body": "A: Check if API Key is correct, ensure service is activated and in \"Trial\" or \"Formal\" status\n检查 API Key 是否正确，确保服务已开通并处于 \"试用中\" 或 \"正式\" 状态"
      },
      {
        "title": "Q: Where to find service URL? | 服务地址在哪里找？",
        "body": "A: AI Gateway Console → Select region → Instance details → Access information/Service address\nAI 网关控制台 → 选择地域 → 实例详情 → 接入信息/服务地址"
      },
      {
        "title": "Q: Free quota exhausted? | 免费额度用完了怎么办？",
        "body": "A: Apply for formal activation | 申请正式开通：https://help.aliyun.com/document_detail/2869993.html"
      },
      {
        "title": "Q: Search results not relevant? | 搜索结果不相关？",
        "body": "A: Enable \"Intent Recognition\" in console to let AI optimize search queries\n在控制台开启 \"意图识别\"，让 AI 自动优化搜索查询"
      },
      {
        "title": "📚 Related Documentation | 相关文档",
        "body": "Aliyun AI Gateway Console | 阿里云 AI 网关控制台\nAPI Key Management | 凭证管理\nWeb Search Official Docs | 联网搜索官方文档\nFormal Activation | 正式开通流程"
      },
      {
        "title": "🔒 Security Notice | 安全提示",
        "body": "⚠️ Do NOT upload API Key to public repositories | 不要将 API Key 上传到公开仓库\n⚠️ Do NOT share your service URL publicly | 不要在公开场合分享你的服务地址\n✅ Use environment variables or encrypted config files | 使用环境变量或加密配置文件存储敏感信息\n✅ Rotate API Keys regularly | 定期轮换 API Key\n\nCreated by 猪王 (Pig King) 🐷 | Based on Aliyun Open Search Platform | 基于阿里云开放搜索平台"
      }
    ],
    "body": "Aliyun Web Search | 阿里云实时搜索\n\n📢 Note: Aliyun's service management is a bit chaotic - this skill helps you configure it step by step!\n\n📢 吐槽：阿里云的服务管理确实有点混乱，这个技能帮你理清配置步骤！\n\nReal-time web search using Aliyun Open Search Platform (AI Gateway) with Quark search engine. Returns latest, accurate Chinese search results.\n\n使用阿里云开放搜索平台（AI 网关）进行实时网页搜索，支持夸克搜索引擎，返回最新、最准确的中文搜索结果。\n\n🎯 Features | 功能特性\n\n✅ Real-time Search - Returns latest web content, not model training data\n\n✅ Chinese Optimized - Quark search engine, high-quality Chinese results\n\n✅ Auto Query Rewrite - Intelligently optimizes search queries\n\n✅ Flexible Configuration - Customizable result count, time range, etc.\n\n✅ Conversation History Support - Can search with context\n\n✅ 实时搜索 - 返回最新网页内容，不是模型训练数据\n\n✅ 中文优化 - 夸克搜索引擎，中文结果质量高\n\n✅ 自动重写 - 智能优化搜索查询\n\n✅ 灵活配置 - 支持自定义结果数量、时间范围等\n\n✅ 支持对话历史 - 可结合上下文进行搜索\n\n📋 Configuration Steps | 配置步骤\nStep 1: Activate Aliyun Information Query Service | 开通阿里云信息查询服务\n\nOpen Aliyun AI Gateway Console | 打开 阿里云 AI 网关控制台：\n\nhttps://apigw.console.aliyun.com/#/cn-hangzhou/ai-gateway\n\n\nSelect your instance region in the top menu (e.g., North China 2-Beijing, East China 1-Hangzhou)\n\n在顶部菜单栏选择你的实例所在地域（如：华北 2-北京、华东 1-杭州等）\n\nClick your instance ID to enter the details page\n\n单击你的实例 ID 进入详情页\n\nLeft navigation → Model API → Click target API name\n\n左侧导航栏 → Model API → 点击目标 API 名称\n\nClick Strategies & Plugins tab\n\n点击 策略与插件 标签\n\nFind Web Search switch and turn it on\n\n找到 联网搜索 开关，打开它\n\nFirst time use shows \"Not Activated\", click Go to Activate\n\n首次使用会显示 \"未开通\"，点击 前往开通\n\nAfter activation, click Activate Validation, status changes to \"Trial\"\n\n开通后点击 开通校验，状态变为 \"试用中\"\n\n💡 Free Trial: 15 days free, 1000 requests/day, 5 QPS limit\n\n💡 免费试用：15 天免费，1000 次/天，5 QPS 性能限制\n\n📖 Formal Activation: https://help.aliyun.com/document_detail/2869993.html\n\nStep 2: Get API Key | 获取 API Key\n\nOpen API Key Management Console | 打开 凭证管理控制台：\n\nhttps://ipaas.console.aliyun.com/api-key\n\n\nClick Create API Key\n\n点击 创建 API Key\n\nCopy your API Key (format: OS-xxxxxxxxxxxxxxxx)\n\n复制你的 API Key（格式：OS-xxxxxxxxxxxxxxxx）\n\n⚠️ Security: API Key is shown only once, save it immediately!\n\n⚠️ 安全提示：API Key 只在第一次显示，记得马上复制保存！\n\nStep 3: Configure Service URL by Region | 配置服务地址（按地区选择）\n\nSelect service address based on your instance region:\n\n根据你的实例所在地域，选择对应的服务地址：\n\nRegion\tService URL Example\nNorth China 2-Beijing (华北 2-北京)\thttp://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com\nEast China 1-Hangzhou (华东 1-杭州)\thttp://default-21rb.platform-cn-hangzhou.opensearch.aliyuncs.com\nSouth China 1-Shenzhen (华南 1-深圳)\thttp://default-21rb.platform-cn-shenzhen.opensearch.aliyuncs.com\nOther Regions (其他地域)\tCheck your instance details page in AI Gateway Console\n\n💡 How to Find Service URL | 如何查看服务地址：\n\nOpen AI Gateway Console | 打开 AI 网关控制台\nSelect your region | 选择你的地域\nClick instance ID | 点击实例 ID\nFind your URL in \"Access Information\" or \"Service Address\" tab | 在 \"接入信息\" 或 \"服务地址\" 标签页找到你的专属地址\nStep 4: Configure in OpenClaw | 配置到 OpenClaw\n\nAdd to openclaw.json:\n\n在 openclaw.json 中添加：\n\n{\n  \"env\": {\n    \"ALIYUN_SEARCH_API_KEY\": \"YOUR_API_KEY\",\n    \"ALIYUN_SEARCH_HOST\": \"YOUR_SERVICE_URL\"\n  },\n  \"skills\": {\n    \"entries\": {\n      \"aliyun-web-search\": {\n        \"enabled\": true,\n        \"env\": {\n          \"ALIYUN_SEARCH_API_KEY\": \"YOUR_API_KEY\",\n          \"ALIYUN_SEARCH_HOST\": \"YOUR_SERVICE_URL\"\n        }\n      }\n    }\n  }\n}\n\n\nExample (Beijing Region) | 示例（北京地区）：\n\n{\n  \"env\": {\n    \"ALIYUN_SEARCH_API_KEY\": \"OS-0fw5937ch3u5eegd\",\n    \"ALIYUN_SEARCH_HOST\": \"http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com\"\n  }\n}\n\n\nRestart gateway after configuration | 配置完成后重启网关：\n\nopenclaw gateway restart\n\n🔧 Advanced Configuration | 高级配置\n\nConfigure in AI Gateway Console | 在 AI 网关控制台配置：\n\nResult Count | 返回结果数量：1-10 (default 5 | 默认 5)\nTimeout | 超时时间：default 3000ms | 默认 3000ms\nTime Range | 查询时间范围：1 day / 1 week / 1 month / 1 year / unlimited\nIndustry Filter | 行业筛选：Finance / Law / Medical / Internet / Tax / News\nContent Type | 内容类型：Snippet (default) / Full Text\nDefault Language | 默认语言：Chinese / English\nShow Citations | 输出引用来源：Yes/No\n💡 Usage Examples | 使用示例\nIn Conversation | 在对话中使用\nUser: Search for latest AI news | 帮我搜索最新的 AI 新闻\nAssistant: [Using aliyun-web-search]\n\nManual Script Call | 手动调用脚本\n\nPowerShell:\n\n$env:ALIYUN_SEARCH_API_KEY=\"OS-xxxxxxxx\"\n$env:ALIYUN_SEARCH_HOST=\"http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com\"\ncd skills/aliyun-web-search\n.\\scripts\\search.ps1 \"AI news\" 5\n\n\nBash:\n\nexport ALIYUN_SEARCH_API_KEY=\"OS-xxxxxxxx\"\nexport ALIYUN_SEARCH_HOST=\"http://default-21rb.platform-cn-beijing.opensearch.aliyuncs.com\"\ncd skills/aliyun-web-search\n./scripts/search.sh \"AI news\" 5\n\n🔍 Search Result Example | 搜索结果示例\n{\n  \"result\": {\n    \"search_result\": [\n      {\n        \"title\": \"AI Development Trends 2026 | 2026 年 AI 发展趋势\",\n        \"link\": \"https://example.com/ai-trends-2026\",\n        \"snippet\": \"AI field will see major breakthroughs in 2026... | 2026 年 AI 领域将迎来重大突破...\",\n        \"publishedTime\": \"2026-02-20T10:00:00+08:00\"\n      }\n    ]\n  }\n}\n\n⚠️ FAQ | 常见问题\nQ: Search returns garbled text? | 搜索返回乱码？\n\nA: Check if API Key is correct, ensure service is activated and in \"Trial\" or \"Formal\" status 检查 API Key 是否正确，确保服务已开通并处于 \"试用中\" 或 \"正式\" 状态\n\nQ: Where to find service URL? | 服务地址在哪里找？\n\nA: AI Gateway Console → Select region → Instance details → Access information/Service address AI 网关控制台 → 选择地域 → 实例详情 → 接入信息/服务地址\n\nQ: Free quota exhausted? | 免费额度用完了怎么办？\n\nA: Apply for formal activation | 申请正式开通：https://help.aliyun.com/document_detail/2869993.html\n\nQ: Search results not relevant? | 搜索结果不相关？\n\nA: Enable \"Intent Recognition\" in console to let AI optimize search queries 在控制台开启 \"意图识别\"，让 AI 自动优化搜索查询\n\n📚 Related Documentation | 相关文档\nAliyun AI Gateway Console | 阿里云 AI 网关控制台\nAPI Key Management | 凭证管理\nWeb Search Official Docs | 联网搜索官方文档\nFormal Activation | 正式开通流程\n🔒 Security Notice | 安全提示\n⚠️ Do NOT upload API Key to public repositories | 不要将 API Key 上传到公开仓库\n⚠️ Do NOT share your service URL publicly | 不要在公开场合分享你的服务地址\n✅ Use environment variables or encrypted config files | 使用环境变量或加密配置文件存储敏感信息\n✅ Rotate API Keys regularly | 定期轮换 API Key\n\nCreated by 猪王 (Pig King) 🐷 | Based on Aliyun Open Search Platform | 基于阿里云开放搜索平台"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/xiaoyunbowen/aliyun-web-search",
    "publisherUrl": "https://clawhub.ai/xiaoyunbowen/aliyun-web-search",
    "owner": "xiaoyunbowen",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/aliyun-web-search",
    "downloadUrl": "https://openagent3.xyz/downloads/aliyun-web-search",
    "agentUrl": "https://openagent3.xyz/skills/aliyun-web-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aliyun-web-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aliyun-web-search/agent.md"
  }
}