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

### Validation

python skills/storage/oss/alicloud-storage-oss-ossutil/scripts/check_ossutil.py --output output/alicloud-storage-oss-ossutil/validate.txt

Pass criteria: command exits 0 and output/alicloud-storage-oss-ossutil/validate.txt is generated.

### Output And Evidence

Save command outputs, object listings, and sync logs under output/alicloud-storage-oss-ossutil/.
Keep at least one upload or listing result as evidence.

### Goals

Use ossutil 2.0 to manage OSS: upload, download, sync, and resource management.
Provide a unified CLI flow for install, config, credentials, and region/endpoint handling.

### Quick Start Flow

Install ossutil 2.0.
Configure AK/SK and default region (ossutil config or config file).
Run ossutil ls to list buckets, then list objects using the bucket region.
Execute upload/download/sync or API-level commands.

### Install ossutil 2.0

See references/install.md for platform-specific install steps.

### Configure ossutil

Interactive configuration:

ossutil config

Default config file paths:

Linux/macOS：~/.ossutilconfig
Windows：C:\\Users\\issuser\\.ossutilconfig

Main configuration fields include:

AccessKey ID
AccessKey Secret
Region（example default cn-hangzhou; ask the user if the best region is unclear）
Endpoint（optional; auto-derived from region if omitted）

### AccessKey configuration notes

Use RAM users/roles with least privilege and avoid passing AK in plain text on command line.

Recommended method (environment variables):

export ALICLOUD_ACCESS_KEY_ID="<your-ak>"
export ALICLOUD_ACCESS_KEY_SECRET="<your-sk>"
export ALICLOUD_REGION_ID="cn-beijing"

ALICLOUD_REGION_ID can be used as default region; if unset choose the most reasonable region, ask user if unclear.

Or use the standard shared credentials file:

~/.alibabacloud/credentials

[default]
type = access_key
access_key_id = <your-ak>
access_key_secret = <your-sk>

### Command structure (2.0)

High-level command example:ossutil config
API-level command example:ossutil api put-bucket-acl

### Common command examples

ossutil ls
ossutil ls oss://your-bucket -r --short-format --region cn-shanghai -e https://oss-cn-shanghai.aliyuncs.com
ossutil cp ./local.txt oss://your-bucket/path/local.txt
ossutil cp oss://your-bucket/path/remote.txt ./remote.txt
ossutil sync ./local-dir oss://your-bucket/path/ --delete

### Recommended execution flow (list buckets first, then objects)

List all buckets

ossutil ls

Get target bucket region from output (e.g. oss-cn-shanghai) and convert it to --region format (cn-shanghai).


When listing objects, explicitly set --region and -e to avoid cross-region signature/endpoint errors.

ossutil ls oss://your-bucket \\
  -r --short-format \\
  --region cn-shanghai \\
  -e https://oss-cn-shanghai.aliyuncs.com

For very large buckets, limit output size first.

ossutil ls oss://your-bucket --limited-num 100
ossutil ls oss://your-bucket/some-prefix/ -r --short-format --region cn-shanghai -e https://oss-cn-shanghai.aliyuncs.com

### Common errors and handling

Error: region must be set in sign version 4.

Cause: missing region configuration.
Fix: add region in config file, or pass --region cn-xxx.



The bucket you are attempting to access must be addressed using the specified endpoint

Cause: request endpoint does not match bucket region.
Fix: use endpoint of the bucket region, e.g. -e https://oss-cn-hongkong.aliyuncs.com.



Invalid signing region in Authorization header

Cause: signature region does not match bucket region.
Fix: correct both --region and -e; both must match bucket region.

### Credential and security guidance

Prefer RAM user AK for access control.
CLI options can override config file, but passing secrets on command line has leakage risk.
In production, manage secrets via config files or environment variables.

### Clarifying questions (ask when uncertain)

Is your target a Bucket or an Object?
Do you need upload/download/sync, or management actions like ACL/lifecycle/CORS?
What are the target region and endpoint?
Are you accessing OSS from ECS in the same region (intranet endpoint may be preferred)?

### References

OSSUTIL 2.0 overview and install/config:

https://help.aliyun.com/zh/oss/developer-reference/ossutil-overview



Official source list:references/sources.md

### 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.
## 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-storage-oss-ossutil)
- [Send to Agent page](https://openagent3.xyz/skills/alicloud-storage-oss-ossutil/agent)
- [JSON manifest](https://openagent3.xyz/skills/alicloud-storage-oss-ossutil/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/alicloud-storage-oss-ossutil/agent.md)
- [Download page](https://openagent3.xyz/downloads/alicloud-storage-oss-ossutil)