通过云助手公共命令安装和管理 OpenClaw-云服务器 ECS(ECS)-阿里云帮助中心

在 ECS 实例上部署 OpenClaw 通常需要手动安装依赖和配置模型，通过云助手公共命令，可快速完成安装部署，同时支持通过云助手公共命令管理模型、消息渠道和 Gateway 服务。

适用范围

在执行公共命令前，请确保目标 ECS 实例满足以下条件：

云助手状态：实例已安装云助手 Agent，且状态为正常。若未安装，请安装云助手Agent。
网络环境：实例需开通公网，以便拉取 OpenClaw 依赖包及模型配置。

支持的操作系统

操作系统	支持版本	公共命令
Linux	Alibaba Cloud Linux 3、Ubuntu 22.04/24.04、Debian 12、Rocky Linux 8/9、AlmaLinux 8/9、CentOS Stream 8/9	`ACS-ECS-InstallOpenClaw-for-linux.sh`
Windows	Windows Server 2016 及以上标准版	`ACS-ECS-InstallOpenClaw-for-windows.ps1`

Windows 实例额外限制：

1. 受 OpenClaw 限制，Gateway 需要用户登录桌面后才能启动，执行相关命令前请确保用户已登录。

2. Windows 版命令不支持以默认用户 system 执行，需在参数中重新指定执行用户（如 Administrator）。如需使用普通用户执行，请配置 Windows 实例的普通用户执行云助手命令。

安装与部署

重要

建议使用 4 核 4 GB 及以上规格的 ECS 实例。如果使用共享型实例（如 ecs.t6、ecs.s6 系列），则建议选择更大规格以确保安装和运行的稳定性。

控制台

前往ECS控制台-云助手。
选择公共命令页签，在搜索框中输入命令关键词ACS-ECS-InstallOpenClaw-for-linux.sh（Linux实例）或ACS-ECS-InstallOpenClaw-for-windows.ps1（windows实例），单击目标公共命令卡片中的执行。
在执行命令窗口中，根据需要配置执行参数（如执行用户、超时时间以及命令参数等），选择需要安装 OpenClaw 的 ECS 实例。执行安装命令时，支持以下命令参数：
- INSTALL_METHOD：安装方式，选择plugin。
- AUTH_CHOICE：请参见支持的模型供应商。
- API_KEY：供应商的 API Key。如需加密传输，请参见如何使用加密 API Key。
单击执行，在命令执行结果页签下，查看执行状态。
- 成功执行：表示 OpenClaw 已安装完成。如需远程访问 OpenClaw Dashboard，请参见通过公网访问 WebUI。
- 执行失败：请根据任务输出和云助手日志排查原因。请参见公共命令执行失败是什么原因？
（可选）安装完成后，OpenClaw 将使用该供应商的默认模型。可通过模型查看与切换命令查看当前模型及配置（ACTION=status）、查看可用模型列表（ACTION=list）或切换模型（ACTION=switch）。

CLI

查看公共命令信息。
执行以下命令查看ACS-ECS-InstallOpenClaw-for-linux.sh公共命令的详细信息：
```
aliyun ecs DescribeCommands \
  --RegionId 'cn-hangzhou' \
  --CommandId 'ACS-ECS-InstallOpenClaw-for-linux.sh'
```
其他命令的 CommandId 格式类似，如 ACS-ECS-OpenClawModel-for-linux.sh。
执行公共命令安装 OpenClaw。
将以下示例中的地域 ID 和实例 ID 替换为实际值。地域 ID 可在控制台左上角查看，实例 ID 可在实例列表页获取。
如需在多台实例上批量安装，通过--InstanceId.N参数指定多个实例 ID，最多支持 100 台。
```
aliyun ecs InvokeCommand \
  --RegionId '<地域ID，如cn-hangzhou>' \
  --CommandId 'ACS-ECS-InstallOpenClaw-for-linux.sh' \
  --InstanceId.1 '<实例ID，如i-bp1xxxxxxxxxxxx>'
```
如需在安装时配置模型，建议使用加密 API Key 而非明文传递，请参见如何使用加密 API Key。
查看执行结果。
命令执行后会返回InvokeId，使用该 ID 查询执行结果：
```
aliyun ecs DescribeInvocationResults \
  --RegionId '<地域ID>' \
  --InvokeId '<执行ID，如t-hz0xxxxxxxxxxxx>'
```
返回结果中Output字段为脚本的标准输出，ErrorInfo字段包含错误信息。

安装完成后，如需远程访问 OpenClaw Dashboard，请参见通过公网访问 WebUI。

其他操作

在云助手公共命令中查询命令，按页面指引完成参数配置后执行。

模型查看与切换

对应公共命令：ACS-ECS-OpenClawModel-for-linux.sh / windows.ps1

用于管理已配置的模型：查询列表、查看状态、切换默认模型、添加新供应商。

常用操作示例

在控制台执行命令时，按以下方式填写参数即可完成对应操作：

查看已配置的模型列表：将 ACTION 设为 list，其他参数留空。
查看模型配置状态：将 ACTION 设为 status，其他参数留空。
切换模型：将 ACTION 设为 switch，MODEL_ID 填写目标模型（如 modelstudio/qwen3.5-plus）。可先通过 ACTION=list 查询可用的模型 ID。
添加新的模型供应商：将 ACTION 设为 setup，AUTH_CHOICE 填写供应商标识（如 modelstudio-standard-api-key-cn），API_KEY 填写对应的 API Key。

更多 ACTION 及参数信息请参见下表。

ACTION 操作

ACTION	说明	必填参数	选填参数
`list`	列出配置的模型。	-	OUTPUT_FORMAT
`status`	查看配置状态与认证概览。	-	OUTPUT_FORMAT
`switch`	切换默认模型。	MODEL_ID	-
`setup`	配置模型供应商。	AUTH_CHOICE	详见参数说明。

参数说明

参数	说明	可选值/示例值
`ACTION`	操作类型（必填）。	list / status / switch / setup
`OUTPUT_FORMAT`	输出格式。	json / plain（默认表格）
`MODEL_ID`	模型 ID（switch 时必填），格式为"供应商/模型名"。可通过 `ACTION=list` 查询已配置的模型列表。	如 modelstudio/qwen3.5-plus。
`AUTH_CHOICE`	认证方式（setup 时必填）。	请参见支持的模型供应商。
`API_KEY`	API Key，建议改用 ENCRYPTED_API_KEY。	-
`ENCRYPTED_API_KEY`	加密 API Key。与 API_KEY 二选一。可通过云助手命令内容加密生成加密密钥。
`KEY_PAIR_ID`	云助手数据加解密密钥对 ID（使用 ENCRYPTED_API_KEY 时必填）。	t-hy03a65fmrd****
`BASE_URL`	自定义端点 URL。	-
`CUSTOM_PROVIDER_ID`	自定义提供商 ID。	-
`CUSTOM_COMPATIBILITY`	API 兼容模式。	openai（默认）/ anthropic

管理消息渠道

对应公共命令：ACS-ECS-OpenClawChannel-for-linux.sh / windows.ps1

配置、查询和管理消息渠道（飞书、企业微信、QQ、钉钉）。

常用操作示例

在控制台执行命令时，按以下方式填写参数即可完成对应操作：

查看已配置的消息渠道：将 ACTION 设为 list，其他参数留空。
查看连接状态：将 ACTION 设为 status。如需探测凭证有效性，将 PROBE 设为 true。
配置飞书渠道：将 ACTION 设为 setup，CHANNEL_TYPE 设为 feishu，PARAM_ID 填写飞书应用的 App ID，PARAM_SECRET 填写 App Secret。其他渠道的配置方式类似，请参见Channel 类型与凭证映射。
查看某个渠道的配置：将 ACTION 设为 get，CHANNEL_TYPE 填写渠道类型（如 feishu）。
禁用某个渠道：将 ACTION 设为 remove，CHANNEL_TYPE 填写要禁用的渠道类型（如 dingtalk）。

更多 ACTION 及参数信息请参见下表。

ACTION 操作

ACTION	说明	必填参数	选填参数
`list`	列出已配置的 Channel。	-	OUTPUT_FORMAT
`status`	查看连接状态。	-	OUTPUT_FORMAT, PROBE
`setup`	配置 Channel。	CHANNEL_TYPE + 凭证	KEY_PAIR_ID
`get`	获取配置信息。	CHANNEL_TYPE	OUTPUT_FORMAT
`remove`	禁用 Channel。	CHANNEL_TYPE	-

参数说明

参数	说明	可选值
`ACTION`	操作类型（必填）。	list / status / setup / get / remove
`CHANNEL_TYPE`	Channel 类型（setup/get/remove 必填）。	详见下方 Channel 类型与凭证映射。
`PARAM_ID`	主凭证。	各 Channel 含义不同，详见下方 Channel 类型与凭证映射。
`PARAM_SECRET`	副凭证（详见下方映射表），建议改用 ENCRYPTED_PARAM_SECRET。	-
`ENCRYPTED_PARAM_SECRET`	加密副凭证。	与 PARAM_SECRET 二选一，可通过云助手命令内容加密生成加密凭证。
`KEY_PAIR_ID`	云助手数据加解密密钥对 ID（使用 ENCRYPTED_API_KEY 时必填）。	使用加密凭证时必填。
`OUTPUT_FORMAT`	输出格式。	json / plain
`PROBE`	探测凭证有效性（仅 status）。	true / false（默认）

Channel 类型与凭证映射

CHANNEL_TYPE	PARAM_ID	PARAM_SECRET	附加行为
`feishu`	App ID	App Secret	自动启用飞书插件。
`wecom`	Bot ID	Bot Secret	自动安装 @wecom/wecom-openclaw-plugin。
`qqbot`	App ID	Client Secret	自动安装 @tencent-connect/openclaw-qqbot。
`dingtalk`	Client ID	Client Secret	自动安装 @dingtalk-real-ai/dingtalk-connector。

管理 Gateway 服务

对应公共命令：ACS-ECS-OpenClawGateway-for-linux.sh / windows.ps1

用于管理 Gateway 服务的启停、安装/卸载、后台运行和 Dashboard 访问。

常用操作示例

在控制台执行命令时，按以下方式填写参数即可完成对应操作：

启动 Gateway：将 ACTION 设为 start，其他参数留空。
查看 Gateway 运行状态：将 ACTION 设为 status。如需深度检测，将 DEEP 设为 true。
重启 Gateway：将 ACTION 设为 restart，其他参数留空。
获取 Dashboard 访问地址：将 ACTION 设为 dashboard，其他参数留空。
注册为系统服务（开机自启）：将 ACTION 设为 install。如需指定端口，填写 PORT（默认 18789）。

更多 ACTION 及参数信息请参见下表。

ACTION 操作

ACTION	说明	选填参数
`start`	启动 Gateway。	-
`stop`	停止 Gateway。	-
`restart`	重启 Gateway。	-
`status`	查看状态和RPC 探测。	DEEP, OUTPUT_FORMAT, TIMEOUT
`install`	注册为系统服务。	PORT, FORCE
`uninstall`	卸载系统服务。	-
`run`	后台运行（非 systemd 环境）。	PORT, BIND, FORCE
`dashboard`	获取 Dashboard URL。	-

参数说明

参数	说明	可选值
`ACTION`	操作类型（必填）。	start / stop / restart / status / install / uninstall / run / dashboard
`PORT`	端口号（默认 18789）。	-
`BIND`	绑定模式（仅 run）。	loopback（默认）/ lan / auto
`FORCE`	强制模式。	true / false（默认）
`DEEP`	深度扫描系统服务（仅 status）。	true / false（默认）
`OUTPUT_FORMAT`	输出格式（仅 status）。	json
`TIMEOUT`	探测超时秒数（仅 status）。	-

诊断与健康检查

对应公共命令：ACS-ECS-OpenClawDiagnose-for-linux.sh / windows.ps1

执行健康检查、查看系统状态、自动修复常见问题。

常用操作示例

在控制台执行命令时，按以下方式填写参数即可完成对应操作：

执行健康检查并自动修复：将 ACTION 设为 doctor，FIX 设为 true。如需深度扫描，将 DEEP 设为 true。
查看系统状态总览：将 ACTION 设为 status，其他参数留空。如需查看完整诊断信息，将 ALL 设为 true。
检查 Gateway 健康状态：将 ACTION 设为 health，其他参数留空。

更多 ACTION 及参数信息请参见下表。

ACTION 操作

ACTION	说明	选填参数
`doctor`	健康检查和自动修复。	FIX, DEEP
`status`	系统状态总览。	OUTPUT_FORMAT, ALL, DEEP, TIMEOUT
`health`	Gateway 健康状态。	OUTPUT_FORMAT, TIMEOUT

参数说明

参数	说明	可选值
`ACTION`	操作类型（必填）。	doctor / status / health
`FIX`	自动修复（仅 doctor）。	true / false（默认）
`DEEP`	深度扫描（doctor/status）。	true / false（默认）
`OUTPUT_FORMAT`	输出格式。	json
`ALL`	完整诊断（仅 status）。	true / false（默认）
`TIMEOUT`	超时秒数（status/health）。	-

卸载与清理

对应公共命令：ACS-ECS-UninstallOpenClaw-for-linux.sh / windows.ps1

卸载 OpenClaw。优先检测并删除云助手插件，如未通过插件安装则执行npm uninstall -g openclaw。

常用操作示例

在控制台执行命令时，按以下方式填写参数即可完成对应操作：

卸载 OpenClaw（保留配置）：所有参数留空，直接执行命令即可。卸载后配置数据保留在 ~/.openclaw 目录，方便后续重装。
卸载并清除所有数据：将 REMOVE_WORKDIR 设为 true，彻底删除工作目录及配置数据。

更多参数信息请参见下表。

参数说明

参数

必填

说明

REMOVE_WORKDIR

选填

是否删除工作目录 ~/.openclaw。

true：清除所有配置数据。
false（默认）：保留配置，方便重装。

警告

如果因 API Key 泄露或安全事件需要卸载 OpenClaw，执行时请务必将REMOVE_WORKDIR参数设为true，以彻底清除磁盘上的凭证数据。

常见问题

公共命令执行失败是什么原因？

常见失败原因包括：

API Key 无效：AUTH_CHOICE 与实际供应商不匹配，或 Key 已过期/格式错误。
端口冲突：18789 端口已被占用，可执行以下命令确认是否被占用。
- Linux: netstat -tlnp | grep 18789
- Windows: netstat -ano | findstr 18789
安装时间过长：Windows 实例中，建议将 OpenClaw 安装目录（默认 C:\Users\<用户名>\.openclaw）添加到 Microsoft Defender 实时保护排除路径，不建议直接关闭实时保护。

更多原因及排查步骤，请参见查看执行结果及修复常见问题。

安装 OpenClaw 后，如何通过公网远程访问 WebUI？

OpenClaw 安装完成后，Gateway 服务默认监听 127.0.0.1:18789，仅允许本地访问。如需通过公网访问 WebUI（Dashboard），可选择以下任一方式：

方式一：SSH 隧道转发（推荐）：在本地终端执行以下命令，然后在本地浏览器访问 http://localhost:18789。
```
ssh -L 18789:127.0.0.1:18789 root@<ECS公网IP>
```
方式二：通过会话管理CLI免公网连接OpenClaw
方式三：修改 Gateway 监听模式为 LAN：
1. 登录 ECS 实例，将 Gateway 绑定模式从 loopback 改为 lan（监听所有网络接口）：
```
openclaw config set gateway.bind lan
openclaw gateway restart
```
2. 在 ECS 安全组中放行入方向 TCP 18789 端口。建议将授权对象限制为您的办公/家庭出口 IP 段，而非 0.0.0.0/0。
3. 在浏览器中访问 http://<ECS公网IP>:18789。
警告
修改为 lan 模式后，Gateway 将监听所有网络接口（0.0.0.0）。请务必在安全组中限制 18789 端口的访问来源 IP，避免向公网所有地址开放。

如何使用加密 API Key？

为避免 API Key 明文传输，建议使用云助手数据加解密功能对 API Key 进行加密。加密后通过以下参数传递：

ENCRYPTED_API_KEY：加密后的 API Key，可通过云助手命令内容加密生成加密密钥。
KEY_PAIR_ID：云助手数据加解密密钥对 ID，可在生成加密密钥时获取。

CLI 示例：

aliyun ecs InvokeCommand \
  --RegionId '<地域ID>' \
  --CommandId 'ACS-ECS-InstallOpenClaw-for-linux.sh' \
  --InstanceId.1 '<实例ID>' \
  --Parameters '{"AUTH_CHOICE":"modelstudio-standard-api-key-cn","ENCRYPTED_API_KEY":"<加密后的Key>","KEY_PAIR_ID":"<OOS密钥对ID>"}'

已购买百炼 Token Plan，如何配置安装部署参数？

使用百炼 Token Plan 安装时，AUTH_CHOICE 需设置为 custom-api-key，同时需要配置以下参数：

API_KEY：Token Plan 团队版专属 API Key。
BASE_URL：百炼的 API 端点地址，Token Plan 团队版Base URL。
MODEL_ID：Token Plan 团队版支持的模型。

OpenClaw 支持哪些模型供应商？

以下为 AUTH_CHOICE 参数支持的供应商列表。安装或切换模型时，将对应的 AUTH_CHOICE 值填入参数即可。

AUTH_CHOICE	供应商
modelstudio-standard-api-key-cn	通义千问 Standard Plan（CN，按量付费）
modelstudio-standard-api-key	通义千问 Standard Plan（Global，pay-as-you-go）
modelstudio-api-key-cn	通义千问 Coding Plan（CN，订阅制）
modelstudio-api-key	通义千问 Coding Plan（Global，subscription）
openai-api-key	OpenAI
anthropic-api-key	Anthropic
deepseek-api-key	DeepSeek
gemini-api-key	Google Gemini
mistral-api-key	Mistral AI
openrouter-api-key	OpenRouter
xai-api-key	xAI（Grok）
volcengine-api-key	火山引擎
byteplus-api-key	BytePlus
qianfan-api-key	百度千帆
moonshot-api-key	Moonshot AI / Kimi K2.5（国际站）
moonshot-api-key-cn	Moonshot AI / Kimi K2.5（中国内地站）
kimi-code-api-key	Kimi Code
xiaomi-api-key	小米
zai-api-key	Z.AI
zai-coding-global	Z.AI Coding Plan（Global）
zai-coding-cn	Z.AI Coding Plan（CN）
zai-global	Z.AI（Global）
zai-cn	Z.AI（CN）
together-api-key	Together AI
huggingface-api-key	Hugging Face
venice-api-key	Venice AI
kilocode-api-key	Kilo Gateway
litellm-api-key	LiteLLM
synthetic-api-key	Synthetic
chutes-api-key	Chutes
opencode-zen	OpenCode（Zen catalog）
opencode-go	OpenCode（Go catalog）
minimax-global-api	MiniMax（Global）
minimax-cn-api	MiniMax（CN）
ai-gateway-api-key	Vercel AI Gateway
custom-api-key	自定义端点（需 BASE_URL + MODEL_ID）