# Send Alicloud Compute Swas Open 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-compute-swas-open",
    "name": "Alicloud Compute Swas Open",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/cinience/alicloud-compute-swas-open",
    "canonicalUrl": "https://clawhub.ai/cinience/alicloud-compute-swas-open",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/alicloud-compute-swas-open",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=alicloud-compute-swas-open",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "agents/openai.yaml",
      "references/api_overview.md",
      "references/command-assistant.md",
      "references/endpoints.md",
      "references/sources.md"
    ],
    "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-compute-swas-open"
    },
    "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-compute-swas-open",
    "downloadUrl": "https://openagent3.xyz/downloads/alicloud-compute-swas-open",
    "agentUrl": "https://openagent3.xyz/skills/alicloud-compute-swas-open/agent",
    "manifestUrl": "https://openagent3.xyz/skills/alicloud-compute-swas-open/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/alicloud-compute-swas-open/agent.md"
  }
}
```
## Documentation

### Simple Application Server (SWAS-OPEN 2020-06-01)

Use SWAS-OPEN OpenAPI to manage full SAS resources: instances, disks, snapshots, images, key pairs, firewall, Cloud Assistant, monitoring, tags, and lightweight databases.

### Prerequisites

Prepare AccessKey with least-privilege RAM user/role.
Choose correct region and matching endpoint (public/VPC).ALICLOUD_REGION_ID can be used as default region; if unset choose the most reasonable region, ask user if unclear.
This OpenAPI uses RPC signing; prefer Python SDK or OpenAPI Explorer instead of manual signing.

### SDK Priority

Python SDK (preferred)
OpenAPI Explorer
Other SDKs

### Python SDK quick query (instance ID / IP / plan)

Virtual environment is recommended (avoid PEP 668 system install restrictions).

python3 -m venv .venv
. .venv/bin/activate
python -m pip install alibabacloud_swas_open20200601 alibabacloud_tea_openapi alibabacloud_credentials

import os
from alibabacloud_swas_open20200601.client import Client as SwasClient
from alibabacloud_swas_open20200601 import models as swas_models
from alibabacloud_tea_openapi import models as open_api_models


def create_client(region_id: str) -> SwasClient:
    config = open_api_models.Config(
        region_id=region_id,
        endpoint=f"swas.{region_id}.aliyuncs.com",
    )
    ak = os.getenv("ALICLOUD_ACCESS_KEY_ID") or os.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
    sk = os.getenv("ALICLOUD_ACCESS_KEY_SECRET") or os.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
    if ak and sk:
        config.access_key_id = ak
        config.access_key_secret = sk
    return SwasClient(config)


def list_regions():
    client = create_client("cn-hangzhou")
    resp = client.list_regions(swas_models.ListRegionsRequest())
    return [r.region_id for r in resp.body.regions]


def list_instances(region_id: str):
    client = create_client(region_id)
    resp = client.list_instances(swas_models.ListInstancesRequest(region_id=region_id))
    return resp.body.instances


def main():
    for region_id in list_regions():
        for inst in list_instances(region_id):
            ip = getattr(inst, "public_ip_address", None) or getattr(inst, "inner_ip_address", None)
            spec = getattr(inst, "plan_name", None) or getattr(inst, "plan_id", None)
            print(inst.instance_id, ip or "-", spec or "-", region_id)


if __name__ == "__main__":
    main()

### Python SDK scripts (recommended for inventory and summary)

All-region instance inventory (TSV/JSON):scripts/list_instances_all_regions.py
Count instances by plan:scripts/summary_instances_by_plan.py
Count instances by status:scripts/summary_instances_by_status.py
Fix SSH key-based access (custom port supported):scripts/fix_ssh_access.py
Get current SSH port of an instance:scripts/get_ssh_port.py

### CLI Notes

aliyun CLI may not expose swas-open as product name; prefer Python SDK.
If CLI is mandatory, generate request examples in OpenAPI Explorer first, then migrate to CLI.

### Workflow

Confirm resource type and region (instance/disk/snapshot/image/firewall/command/database/tag).
Identify API group and operation in references/api_overview.md.
Choose invocation method (Python SDK / OpenAPI Explorer / other SDK).
After mutations, verify state/results with query APIs.

### Common Operation Map

Instance query/start/stop/reboot:ListInstances、StartInstance(s)、StopInstance(s)、RebootInstance(s)
Command execution:RunCommand or CreateCommand + InvokeCommand; use DescribeInvocations/DescribeInvocationResult
Firewall:ListFirewallRules/CreateFirewallRule(s)/ModifyFirewallRule/EnableFirewallRule/DisableFirewallRule
Snapshot/disk/image:CreateSnapshot、ResetDisk、CreateCustomImage etc.

### Cloud Assistant Execution Notes

Target instance must be in Running state.
Cloud Assistant agent must be installed (use InstallCloudAssistant).
For PowerShell commands, ensure required modules are available on Windows instances.
After execution, use DescribeInvocations or DescribeInvocationResult to fetch status and outputs.

See references/command-assistant.md for details.

### Clarifying questions (ask when uncertain)

What is the target region? Is VPC endpoint required?
What are target instance IDs? Are they currently Running?
What command/script type/timeout is needed? Linux or Windows?
Do you need batch execution or scheduled execution?

### Output Policy

If you need to save results or responses, write to:
output/compute-swas-open/

### Validation

mkdir -p output/alicloud-compute-swas-open
for f in skills/compute/swas/alicloud-compute-swas-open/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-compute-swas-open/validate.txt

Pass criteria: command exits 0 and output/alicloud-compute-swas-open/validate.txt is generated.

### Output And Evidence

Save artifacts, command outputs, and API response summaries under output/alicloud-compute-swas-open/.
Include key parameters (region/resource id/time range) in evidence files for reproducibility.

### Prerequisites

Configure least-privilege Alibaba Cloud credentials before execution.
Prefer environment variables: ALICLOUD_ACCESS_KEY_ID, ALICLOUD_ACCESS_KEY_SECRET, optional ALICLOUD_REGION_ID.
If region is unclear, ask the user before running mutating operations.

### 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

API overview and operation groups:references/api_overview.md
Endpoints and integration:references/endpoints.md
Cloud Assistant highlights:references/command-assistant.md
Official source list:references/sources.md
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: cinience
- Version: 1.0.2
## 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-compute-swas-open)
- [Send to Agent page](https://openagent3.xyz/skills/alicloud-compute-swas-open/agent)
- [JSON manifest](https://openagent3.xyz/skills/alicloud-compute-swas-open/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/alicloud-compute-swas-open/agent.md)
- [Download page](https://openagent3.xyz/downloads/alicloud-compute-swas-open)