使用 Skill 安装和管理 ECS 扩展程序

在 OpenClaw、Cursor 等 AI 平台中通过自然语言对话，可直接查询、验证、安装和卸载 ECS 扩展程序。

功能概述

扩展程序 Skill 基于阿里云系统运维管理（CloudOps Orchestration Service, OOS）和云助手（Cloud Assistant），提供以下能力：

查询可用扩展程序：列出所有公共扩展程序，包括名称、描述、支持的操作系统和分类信息。
验证扩展程序兼容性：检查特定扩展程序是否支持目标实例的操作系统版本。
安装和卸载扩展程序：在一个或多个 ECS 实例上安装或卸载扩展程序，支持参数确认、执行状态轮询和结果报告。

目前支持的扩展程序包括 OpenClaw、宝塔面板、Docker CE、Java、Python、Node.js、Nginx、WordPress、Claude Code、qwen-code、QoderCLI、1Panel、MySQL 等。

适甩范围

控制端（运行 AI 智能体平台的环境）：

AI 智能体平台已就绪：已安装并配置支持 Skill 协议的 AI 智能体平台（如 OpenClaw、Cursor、Claude 等）。
阿里云 CLI 版本 ：需要阿里云 CLI 3.3.1 及以上版本。运行 aliyun version 查看当前版本，版本过低请升级。
阿里云账号凭证 ：已在阿里云CLI中配置身份凭证。运行 aliyun configure list 确认凭证状态。

RAM 权限 ：使用扩展程序安装 Skill，阿里云账号或 RAM 用户需要授予以下权限。具体操作，请参见为RAM用户授权。

RAM Policy

json 复制代码

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bss:DescribeOrderDetail",
        "ecs:DescribeCloudAssistantStatus",
        "ecs:DescribeInstances",
        "ecs:DescribeInvocations",
        "ecs:DescribeInvocationResults",
        "ecs:RunCommand",
        "oos:GetApplicationGroup",
        "oos:GetTemplate",
        "oos:ListExecutions",
        "oos:ListInstancePackageStates",
        "oos:ListTemplates",
        "oos:StartExecution",
        "oos:UpdateInstancePackageState",
        "oss:GetObject"
      ],
      "Resource": "*"
    }
  ]
}

目标端（需安装扩展程序的 ECS 实例）：

实例状态 ：目标 ECS 实例已安装云助手 Agent。若未安装，请安装云助手Agent。
网络连通 ：部分扩展程序安装时需要公网访问能力，具体要求请通过 Skill 获取扩展详情查看。如需开通公网，请参见开通公网。

添加 Skill

扩展程序 Skill 已发布至阿里云Skill平台和 ClawHub，支持以下添加方式：

对话添加（推荐）

在 AI 智能体平台的 Agent 模式对话界面中发送以下提示词，即可自动完成 Skill 添加和配置：

bash 复制代码

Install the skill "Alibabacloud Ecs Install Extension" (sdk-team/alibabacloud-ecs-install-extension) from ClawHub.
Skill page: https://clawhub.ai/sdk-team/alibabacloud-ecs-install-extension
After install, inspect the skill metadata and help me finish setup.

命令行添加（OpenClaw）

在 OpenClaw 环境中，通过 CLI 直接添加：

bash 复制代码

openclaw skills install alibabacloud-ecs-install-extension

手动添加

在 AI 智能体平台的 Skill 管理页面中，添加以下 Skill 地址：

arduino 复制代码

https://skills.aliyun.com/skills/alibabacloud-ecs-install-extension

使用场景

Skill 支持以下使用场景。在 AI 智能体平台的对话界面中，使用自然语言描述需求即可触发对应流程。

查询可用扩展程序列表

查询所有公共扩展程序的名称、描述和分类信息。

示例对话：

"有哪些可用的扩展程序？"
"列出所有支持的扩展"
"查看扩展程序列表"

Skill 调用 OOS ListTemplates API 查询公共扩展包，解析每个扩展的名称、描述和分类信息，以表格形式返回结果。

查询特定扩展程序是否支持

确认特定扩展程序是否可用，以及支持的操作系统版本。

示例对话：

"OpenClaw 支持安装吗？"
"有没有 Python 环境的扩展？"
"宝塔面板支持哪些操作系统？"

如果匹配到目标扩展程序，Skill 返回名称、描述、支持的操作系统和平台等详细信息。如果未匹配，Skill 会推荐相似的扩展程序或引导浏览完整列表。

安装扩展程序

在一个或多个 ECS 实例上安装指定的扩展程序。完整安装流程包括以下步骤：

确认扩展名称：Skill 根据输入关键词搜索并确认目标扩展程序的完整名称。如果名称模糊，Skill 先执行查询以明确目标。
获取安装参数：Skill 自动获取扩展程序模板，提取所需的安装参数（如版本号、配置项等），并引导提供必填参数的值。
确认参数：安装前，Skill 输出参数确认表，列出地域 ID、实例 ID、扩展名称和安装参数，等待确认后执行。
执行安装：Skill 通过 OOS StartExecution API 创建安装任务，自动轮询执行状态（每 20 秒检查一次，最长等待 20 分钟）。
输出安装报告：安装完成后，Skill 输出安装报告，包含执行 ID、状态、完成时间和后续建议。

示例对话：

"帮我在 i-bp1xxxxxxxx 上安装 Node.js"
"在杭州地域的实例上安装宝塔面板"
"安装 Python 环境，版本 3.12"

卸载扩展程序

从一个或多个 ECS 实例上卸载已安装的扩展程序。卸载流程与安装流程类似，Skill 会确认卸载目标和参数后执行操作，并轮询执行状态直至完成。

示例对话：

"帮我卸载 i-bp1xxxxxxxx 上的 Node.js 扩展"
"卸载杭州地域实例上的宝塔面板"
"移除实例上已安装的 Python 环境"

常见问题

安装失败如何排查？

安装失败的常见原因及解决方式：

实例未运行：确认目标实例处于运行中状态。
网络不通：若扩展程序要求公网访问，确认实例已开通公网且安全组允许出方向流量。
操作系统不兼容：确认目标实例的操作系统版本在扩展程序支持范围内。
参数格式错误 ：Skill 对关键参数执行格式验证，InstanceId 需匹配 ^i-[a-zA-Z0-9]{10,30}$，RegionId 必须为有效的阿里云地域 ID，PackageName 需匹配 ^[a-zA-Z0-9][a-zA-Z0-9\-]*$。扩展参数也有特定要求，例如 OpenClaw 的 API_KEY 必须以 sk- 开头。
磁盘空间不足：确认实例有足够的磁盘空间安装扩展程序。

CLI 版本过低如何处理？

阿里云 CLI 3.0.x 版本不支持插件模式（Plugin Mode）和 AI 模式命令。需要升级到 3.3.1 及以上版本。

安装超时但实际还在运行怎么办？

Skill 最长轮询 20 分钟。如果安装任务超时但仍在运行，使用以下命令手动查询执行状态：

bash 复制代码

aliyun oos list-executions --biz-region-id "<地域ID>" --execution-id "<执行ID>"

执行 ID 可从 Skill 输出的安装报告中获取。

能否同时在多个实例上安装？

支持。提供多个实例 ID，Skill 通过 OOS 的批量执行能力在多个实例上并行安装，单次最多支持 50 个实例。

支持哪些操作系统？

支持的操作系统取决于具体扩展程序。可通过以下方式确认兼容性：

在 AI 智能体平台中使用自然语言查询，例如"宝塔面板支持哪些操作系统？"。Skill 会调用 OOS GetTemplate API 获取模板详情并返回支持的操作系统信息。
通过阿里云 CLI 执行 aliyun oos get-template --template-name <模板名称>，从响应中查看操作系统兼容性字段。

安装前请确认目标实例的操作系统在扩展程序的兼容列表中，避免安装失败。