# Send Alicloud Ai Search Opensearch to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "alicloud-ai-search-opensearch", "name": "Alicloud Ai Search Opensearch", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/cinience/alicloud-ai-search-opensearch", "canonicalUrl": "https://clawhub.ai/cinience/alicloud-ai-search-opensearch", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/alicloud-ai-search-opensearch", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=alicloud-ai-search-opensearch", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "agents/openai.yaml", "references/sources.md", "scripts/quickstart.py" ], "downloadMode": "redirect", "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/alicloud-ai-search-opensearch" }, "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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/alicloud-ai-search-opensearch", "downloadUrl": "https://openagent3.xyz/downloads/alicloud-ai-search-opensearch", "agentUrl": "https://openagent3.xyz/skills/alicloud-ai-search-opensearch/agent", "manifestUrl": "https://openagent3.xyz/skills/alicloud-ai-search-opensearch/agent.json", "briefUrl": "https://openagent3.xyz/skills/alicloud-ai-search-opensearch/agent.md" } } ``` ## Documentation ### OpenSearch Vector Search Edition Use the ha3engine SDK to push documents and execute HA/SQL searches. This skill focuses on API/SDK usage only (no console steps). ### Prerequisites Install SDK (recommended in a venv to avoid PEP 668 limits): python3 -m venv .venv . .venv/bin/activate python -m pip install alibabacloud-ha3engine Provide connection config via environment variables: OPENSEARCH_ENDPOINT (API domain) OPENSEARCH_INSTANCE_ID OPENSEARCH_USERNAME OPENSEARCH_PASSWORD OPENSEARCH_DATASOURCE (data source name) OPENSEARCH_PK_FIELD (primary key field name) ### Quickstart (push + search) import os from alibabacloud_ha3engine import models, client from Tea.exceptions import TeaException, RetryError cfg = models.Config( endpoint=os.getenv("OPENSEARCH_ENDPOINT"), instance_id=os.getenv("OPENSEARCH_INSTANCE_ID"), protocol="http", access_user_name=os.getenv("OPENSEARCH_USERNAME"), access_pass_word=os.getenv("OPENSEARCH_PASSWORD"), ) ha3 = client.Client(cfg) def push_docs(): data_source = os.getenv("OPENSEARCH_DATASOURCE") pk_field = os.getenv("OPENSEARCH_PK_FIELD", "id") documents = [ {"fields": {"id": 1, "title": "hello", "content": "world"}, "cmd": "add"}, {"fields": {"id": 2, "title": "faq", "content": "vector search"}, "cmd": "add"}, ] req = models.PushDocumentsRequestModel({}, documents) return ha3.push_documents(data_source, pk_field, req) def search_ha(): # HA query example. Replace cluster/table names as needed. query_str = ( "config=hit:5,format:json,qrs_chain:search" "&&query=title:hello" "&&cluster=general" ) ha_query = models.SearchQuery(query=query_str) req = models.SearchRequestModel({}, ha_query) return ha3.search(req) try: print(push_docs().body) print(search_ha()) except (TeaException, RetryError) as e: print(e) ### Script quickstart python skills/ai/search/alicloud-ai-search-opensearch/scripts/quickstart.py Environment variables: OPENSEARCH_ENDPOINT OPENSEARCH_INSTANCE_ID OPENSEARCH_USERNAME OPENSEARCH_PASSWORD OPENSEARCH_DATASOURCE OPENSEARCH_PK_FIELD (optional, default id) OPENSEARCH_CLUSTER (optional, default general) Optional args: --cluster, --hit, --query. ### SQL-style search from alibabacloud_ha3engine import models sql = "select * from &&kvpair=trace:INFO;formatType:json" sql_query = models.SearchQuery(sql=sql) req = models.SearchRequestModel({}, sql_query) resp = ha3.search(req) print(resp) ### Notes for Claude Code/Codex Use push_documents for add/delete updates. Large query strings (>30KB) should use the RESTful search API. HA queries are fast and flexible for vector + keyword retrieval; SQL is helpful for structured data. ### Error handling Auth errors: verify username/password and instance access. 4xx on push: check schema fields and pk_field alignment. 5xx: retry with backoff. ### Validation mkdir -p output/alicloud-ai-search-opensearch for f in skills/ai/search/alicloud-ai-search-opensearch/scripts/*.py; do python3 -m py_compile "$f" done echo "py_compile_ok" > output/alicloud-ai-search-opensearch/validate.txt Pass criteria: command exits 0 and output/alicloud-ai-search-opensearch/validate.txt is generated. ### Output And Evidence Save artifacts, command outputs, and API response summaries under output/alicloud-ai-search-opensearch/. Include key parameters (region/resource id/time range) in evidence files for reproducibility. ### Workflow Confirm user intent, region, identifiers, and whether the operation is read-only or mutating. Run one minimal read-only query first to verify connectivity and permissions. Execute the target operation with explicit parameters and bounded scope. Verify results and save output/evidence files. ### References SDK package: alibabacloud-ha3engine Demos: data push and HA/SQL search demos in OpenSearch docs Source list: references/sources.md ## Trust - Source: tencent - Verification: Indexed source record - Publisher: cinience - Version: 1.0.3 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/alicloud-ai-search-opensearch) - [Send to Agent page](https://openagent3.xyz/skills/alicloud-ai-search-opensearch/agent) - [JSON manifest](https://openagent3.xyz/skills/alicloud-ai-search-opensearch/agent.json) - [Markdown brief](https://openagent3.xyz/skills/alicloud-ai-search-opensearch/agent.md) - [Download page](https://openagent3.xyz/downloads/alicloud-ai-search-opensearch)