使用 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{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 添加和配置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 直接添加openclaw skillsinstallalibabacloud-ecs-install-extension手动添加在 AI 智能体平台的 Skill 管理页面中添加以下 Skill 地址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 必须为有效的阿里云地域 IDPackageName 需匹配^[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 分钟。如果安装任务超时但仍在运行使用以下命令手动查询执行状态aliyun oos list-executions --biz-region-id地域ID--execution-id执行ID执行 ID 可从 Skill 输出的安装报告中获取。能否同时在多个实例上安装支持。提供多个实例 IDSkill 通过 OOS 的批量执行能力在多个实例上并行安装单次最多支持 50 个实例。支持哪些操作系统支持的操作系统取决于具体扩展程序。可通过以下方式确认兼容性在 AI 智能体平台中使用自然语言查询例如宝塔面板支持哪些操作系统。Skill 会调用 OOS GetTemplate API 获取模板详情并返回支持的操作系统信息。通过阿里云 CLI 执行aliyun oos get-template --template-name 模板名称从响应中查看操作系统兼容性字段。安装前请确认目标实例的操作系统在扩展程序的兼容列表中避免安装失败。