在多台 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 相关进程或服务是否正常运行。