使用 Skill 掃描或安裝系統補丁 -

使用補丁管理 Skill 在 OpenClaw、Cursor 等 AI 平台中通過自然語言對話，可直接掃描和安裝 ECS 執行個體的系統補丁。

功能概述

補丁管理 Skill 基於阿里雲系統營運管理（CloudOps Orchestration Service, OOS）和雲助手（Cloud Assistant），提供以下能力：

掃描系統補丁：檢查一個或多個 ECS 執行個體的作業系統補丁狀態，識別缺失的安全更新和系統修複。
安裝系統補丁：在一個或多個 ECS 執行個體上安裝缺失的系統補丁，支援重啟策略配置和快照備份。
補丁基準管理：支援指定補丁基準名稱，按照預定義的基準規則篩選和安裝補丁。

Skill 通過 OOS 模板 ACS-ECS-BulkyApplyPatchBaseline 執行補丁操作，支援批量處理最多 1000 個執行個體，並自動輪詢執行狀態直至完成。

適用範圍

控制端（運行 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": [
        "ecs:CreateSnapshot",
        "ecs:DescribeInstances",
        "ecs:DescribeInvocationResults",
        "ecs:DescribeInvocations",
        "ecs:DescribeSnapshots",
        "ecs:InvokeCommand",
        "oos:CancelExecution",
        "oos:GetPatchBaseline",
        "oos:GetTemplate",
        "oos:ListExecutions",
        "oos:ListInstancePatches",
        "oos:ListInstancePatchStates",
        "oos:ListPatchBaselines",
        "oos:ListTemplates",
        "oos:StartExecution"
      ],
      "Resource": "*"
    }
  ]
}

目標端（需執行補丁操作的 ECS 執行個體）：

執行個體狀態：目標 ECS 執行個體已安裝雲助手 Agent。若未安裝，請安裝雲助手Agent。
網路連通：執行個體需要公網訪問能力以下載補丁包。如需開通公網，請參見開通公網。
作業系統：支援 Linux（CentOS、Ubuntu、Alibaba Cloud Linux、Debian 等）和 Windows Server 系列。

添加 Skill

補丁管理 Skill 發行至阿里雲Skill平台和 ClawHub，支援以下添加方式：

對話添加（推薦）

在 AI 智能體平台的 Agent 模式對話介面中發送以下提示詞，即可自動完成 Skill 添加和配置：

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

命令列添加（OpenClaw）

在 OpenClaw 環境中，通過 CLI 直接添加：

openclaw skills install alibabacloud-ecs-patch-management

手動添加

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

https://skills.aliyun.com/skills/alibabacloud-ecs-patch-management

使用情境

Skill 支援以下使用情境。在 AI 智能體平台的對話介面中，使用自然語言描述需求即可觸發對應流程。

掃描系統補丁

掃描一個或多個 ECS 執行個體的系統補丁狀態，識別缺失的補丁。掃描流程包括以下步驟：

確認目標執行個體：Skill 根據輸入的執行個體 ID 和地區資訊確認目標執行個體。
確認參數：Skill 輸出參數確認表，列出地區 ID、執行個體 ID、操作類型（掃描）和補丁基準名稱，等待確認後執行。
執行掃描：Skill 通過 OOS StartExecution API 建立掃描任務，自動輪詢執行狀態（每 20 秒檢查一次，最長等待 20 分鐘）。
輸出掃描報告：掃描完成後，Skill 輸出報告，包含執行 ID、缺失補丁數量、補丁詳情和後續建議。

樣本對話：

"掃描 i-bp1xxxxxxxx 的系統補丁狀態"
"檢查杭州地區執行個體有哪些缺失的補丁"
"幫我看看這台執行個體需要安裝哪些安全更新"

安裝系統補丁

在一個或多個 ECS 執行個體上安裝缺失的系統補丁。安裝流程包括以下步驟：

確認目標執行個體：Skill 根據輸入的執行個體 ID 和地區資訊確認目標執行個體。
配置安裝參數：Skill 引導確認重啟策略、是否建立快照備份等選擇性參數。
確認參數：安裝前，Skill 輸出參數確認表，列出地區 ID、執行個體 ID、操作類型（安裝）、重啟策略、快照配置等，等待確認後執行。
執行安裝：Skill 通過 OOS StartExecution API 建立安裝任務，自動輪詢執行狀態（每 20 秒檢查一次，最長等待 20 分鐘）。
輸出安裝報告：安裝完成後，Skill 輸出報告，包含執行 ID、安裝結果、重啟狀態和後續建議。

樣本對話：

"幫我在 i-bp1xxxxxxxx 上安裝系統補丁"
"安裝補丁前先建立快照，安裝後稍後重啟"
"在杭州地區的 3 台執行個體上安裝安全補丁，不需要重啟"

參數說明

Skill 支援以下參數配置：

參數	是否必填	說明
RegionId	是	目標執行個體所在地區 ID，例如 `cn-hangzhou`。
InstanceIds	是	目標執行個體 ID 列表，單次最多支援 1000 個執行個體。
Action	是	操作類型，可選值為 `scan`（掃描）或 `install`（安裝）。
rebootIfNeed	否	安裝補丁後是否允許重啟執行個體，預設為否。僅在 `Action` 為 `install` 時生效。
whetherCreateSnapshot	否	安裝前是否建立系統硬碟快照備份，預設為否。僅在 `Action` 為 `install` 時生效。
retentionDays	否	快照保留天數，取值範圍 1~65536，預設 7 天。僅在 `Action` 為 `install` 時生效。

常見問題

補丁掃描或安裝失敗如何排查？

操作失敗的常見原因及解決方式：

執行個體未運行：確認目標執行個體處於運行中狀態。
網路不通：執行個體需要公網訪問能力以串連補丁源。確認執行個體已開通公網且安全性群組允許出方向流量。
雲助手 Agent 未安裝或離線：確認目標執行個體已安裝雲助手 Agent 且處於線上狀態。
磁碟空間不足：確認執行個體有足夠的磁碟空間下載和安裝補丁包。
許可權不足：確認當前帳號具有所需的 RAM 許可權。

安裝補丁後是否需要重啟？

取決於補丁類型。核心更新類補丁通常需要重啟才會生效，應用程式層補丁一般不需要重啟。可通過 rebootIfNeed 參數控制重啟行為：

true：允許系統在補丁安裝後按需自動重啟
false（預設）：不自動重啟，補丁安裝後由您手動決定重啟時間

操作逾時但任務還在運行怎麼辦？

Skill 最長輪詢 20 分鐘。如果任務逾時但仍在運行，使用以下命令手動查詢執行狀態：

aliyun oos list-executions --biz-region-id "<地區ID>" --execution-id "<執行ID>"

執行 ID 可從 Skill 輸出的報告中擷取。

能否同時在多個執行個體上操作？

支援。提供多個執行個體 ID，Skill 通過 OOS 的批量執行能力在多個執行個體上並行操作，單次最多支援 50 個執行個體。

建議安裝補丁前建立快照嗎？

建議在生產環境中開啟快照備份。設定 whetherCreateSnapshot 為 true，並指定合適的 retentionDays（預設 7 天）。如果補丁安裝後出現相容性問題，可通過快照快速復原系統硬碟。