在多台 ECS 執行個體上部署 AI 代理平台 OpenClaw 時，手動登入每台執行個體執行指令碼效率低且難以統一管理。通過雲助手公用命令，可實現免登入執行個體、多執行個體的 OpenClaw 自動化大量安裝，顯著提升營運效率並降低操作風險。
適用範圍
請根據下表確認執行個體作業系統與對應的公用命令：
作業系統類型 | 支援版本 | 對應的公用命令名稱 |
Linux | Alibaba Cloud Linux 3、Ubuntu 22.04/24.04、Debian 12、Rocky Linux 8/9、AlmaLinux 8/9、CentOS Stream 8/9 |
|
Windows | Windows Server 2016 及以上標準版 |
|
網路要求：執行個體已開通公網並能正常訪問阿里雲雲助手服務端。
許可權要求：操作帳號需具備執行相關公用命令的 RAM 許可權。
操作步驟
可以通過控制台或 CLI 方式執行雲助手公用命令安裝 OpenClaw，以下操作以Alibaba Cloud Linux 3執行個體為例。
控制台
登入ECS控制台-雲助手，確認目標執行個體狀態為運行中，雲助手狀態為正常。
若雲助手狀態顯示未安裝，請參見安裝雲助手Agent。
在頁面上方，單擊公用命令頁簽。
在搜尋方塊中輸入
ACS-ECS-OpenClaw-linux.sh，找到對應公用命令，單擊執行。在選擇執行個體地區，選擇需要安裝 OpenClaw 的 ECS 執行個體。確認執行個體運行狀態正常，且作業系統在本文適用範圍內。
根據需要配置執行參數（如執行計畫、逾時時間等），單擊執行。
在命令執行結果頁簽下，查看執行狀態。
執行成功：表示 OpenClaw 已安裝完成。
執行失敗：請根據任務輸出和雲助手日誌排查原因。具體操作，請參見查看執行結果及修複常見問題。
CLI
查看公用命令資訊。
執行以下命令查看
ACS-ECS-OpenClaw-linux.sh公用命令的詳細資料：aliyun ecs DescribeCommands \ --RegionId 'cn-hangzhou' \ --CommandId 'ACS-ECS-OpenClaw-linux.sh'執行公用命令安裝 OpenClaw。
將以下樣本中的地區 ID 和執行個體 ID 替換為實際值。地區 ID 可在控制台左上方查看，執行個體 ID 可在執行個體列表頁擷取。
aliyun ecs InvokeCommand \ --RegionId 'cn-hangzhou' \ --CommandId 'ACS-ECS-OpenClaw-linux.sh' \ --InstanceId.1 'i-bp1************xxxx'說明如需在多台執行個體上大量安裝，通過
--InstanceId.N參數指定多個執行個體 ID，最多支援 100 台。查看執行結果。
命令執行後會返回
InvokeId，使用該 ID 查詢執行結果：aliyun ecs DescribeInvocationResults \ --RegionId 'cn-hangzhou' \ --InvokeId 't-hz0xxxxxxxxxxxx'返回結果中
Output欄位為指令碼的標準輸出，ErrorInfo欄位包含錯誤資訊。
應用於生產環境
執行策略：雖然安裝過程通常不會中斷業務，但建議在業務低峰期執行安裝操作，以規避網路頻寬突增或系統資源佔用對核心業務的影響。
風險防範：
系統檢查：請嚴格核對作業系統版本，在不支援的系統上強制執行可能導致安裝中斷或環境配置異常。
容錯處理：若部分執行個體安裝失敗，請先通過雲助手日誌排查網路或許可權問題，修複後再針對失敗執行個體進行重試。
後續監控：安裝完成後，建議通過雲助手或登入執行個體將 OpenClaw 相關進程納入日常監控體系，確保服務高可用。
常見問題
命令執行失敗怎麼辦？
請按照以下順序排查：
確認執行個體作業系統是否在本文適用範圍內。
檢查執行個體是否能正常訪問雲助手服務。
檢查雲助手用戶端是否正常運行。具體操作，請參見查看雲助手狀態及異常狀態處理。
查看雲助手任務輸出和系統日誌。具體操作，請參見查看執行結果及修複常見問題。
如何確認是否安裝成功？
通過以下方式確認：
查看執行狀態：在雲助手命令執行結果頁簽中，確認任務狀態為執行完成且退出碼（ExitCode）為 0。
查看任務輸出：單擊對應任務，查看輸出內容，確認包含安裝成功的提示資訊。
登入執行個體驗證：登入目標執行個體，檢查 OpenClaw 相關進程或服務是否正常運行。