在 ECS 实例上部署 OpenClaw 通常需要手动安装依赖和配置模型。通过云助手公共命令，可一键完成安装部署，并管理模型、消息渠道和 Gateway 服务。
安装方式
安装 OpenClaw 时，可通过公共命令的 INSTALL_METHOD 参数选择安装方式：
INSTALL_METHOD=plugin（默认）
以云助手插件方式安装。云助手将 OpenClaw 封装为插件包 ACS-ECS-OpenClaw，通过插件分发系统快速部署，内置 Node.js 运行时（Linux v22.21.1，Windows v22.22.2），无需额外安装依赖。
Linux 安装路径：/usr/local/share/aliyun-assist/plugin/ACS-ECS-OpenClaw
Windows 安装路径：C:\ProgramData\aliyun\assist\plugin\ACS-ECS-OpenClaw
INSTALL_METHOD=native
执行 OpenClaw 官方安装脚本，自动补齐 Node.js、Git 等缺失依赖。安装耗时取决于网络和系统环境，可能较长。
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 |
公共命令参考
Linux 和 Windows 版命令参数含义一致，以下以 Linux 版说明。
Windows 版命令有以下使用限制：
必须指定用户名（如 Administrator）执行，不支持以默认用户 system 执行。参见配置 Windows 实例的普通用户执行云助手命令。
受 OpenClaw 限制，Gateway 需要用户登录桌面后才能启动，执行相关命令前需确保用户已登录。
建议安装期间暂时关闭 Microsoft Defender 实时保护，可缩短安装时间。
命令 | 用途 | 典型场景 |
InstallOpenClaw | 安装 OpenClaw + 配置模型 + 启动 Gateway | 首次部署 |
OpenClawModel | 模型查询、切换、供应商配置 | 日常配置 |
OpenClawChannel | Channel（飞书/企微/QQ/钉钉）管理 | 日常配置 |
OpenClawGateway | Gateway 启停、服务管理、Dashboard 访问（默认端口 18789） | 日常运维 |
OpenClawDiagnose | 健康检查、状态探测 | 诊断维护 |
UninstallOpenClaw | 卸载 OpenClaw 并清理 | 下线清理 |
InstallOpenClaw：安装部署
首次部署时使用，自动按顺序执行以下步骤：
部署 ACS-ECS-OpenClaw 插件包
（可选）配置模型供应商
安装并启动 Gateway 服务
安装完成后，Gateway 服务自动运行在端口 18789（仅本地访问）。如需远程访问 Dashboard，可通过 SSH 隧道转发该端口，或者通过会话管理CLI免公网连接OpenClaw实现安全访问。
参数说明
参数 | 必填 | 说明 |
INSTALL_METHOD | 必填 | 安装方式。plugin（默认，推荐）：以云助手插件方式安装；native：执行官方脚本安装 |
AUTH_CHOICE | 选填 | 认证方式，为空时跳过模型配置 |
API_KEY | 条件必填 | API Key（简单 API Key 类供应商必填），建议改用 ENCRYPTED_API_KEY |
ENCRYPTED_API_KEY | 选填 | 加密 API Key（与 API_KEY 二选一，使用云助手数据加解密功能） |
KEY_PAIR_ID | 条件必填 | 密钥对 ID（使用 ENCRYPTED_API_KEY 时必填） |
MODEL_ID | 条件必填 | 模型 ID（AUTH_CHOICE 为 custom-api-key 时必填） |
BASE_URL | 条件必填 | 自定义端点 URL（AUTH_CHOICE 为 custom-api-key 时必填） |
CUSTOM_PROVIDER_ID | 选填 | 自定义提供商 ID，默认从 URL 推导 |
CUSTOM_COMPATIBILITY | 选填 | API 兼容模式：openai（默认）或 anthropic |
AUTH_CHOICE 可选值见 OpenClawModel 命令的供应商列表。
建议使用 ENCRYPTED_API_KEY 而非明文 API_KEY。可通过云助手命令内容加密生成加密密钥。
使用示例
仅安装（不配置模型）：
INSTALL_METHOD=
AUTH_CHOICE=
API_KEY=
ENCRYPTED_API_KEY=
KEY_PAIR_ID=
MODEL_ID=
BASE_URL=
CUSTOM_PROVIDER_ID=
CUSTOM_COMPATIBILITY=安装并配置百炼按量付费（明文密钥）：
INSTALL_METHOD=
AUTH_CHOICE=modelstudio-standard-api-key-cn
API_KEY=sk-xxxxxxxxxxxxxxxx
ENCRYPTED_API_KEY=
KEY_PAIR_ID=
MODEL_ID=
BASE_URL=
CUSTOM_PROVIDER_ID=
CUSTOM_COMPATIBILITY=安装并配置百炼按量付费（加密密钥）：
INSTALL_METHOD=
AUTH_CHOICE=modelstudio-standard-api-key-cn
API_KEY=
ENCRYPTED_API_KEY=AQICAHh...base64...==
KEY_PAIR_ID=key-pair-12345678
MODEL_ID=
BASE_URL=
CUSTOM_PROVIDER_ID=
CUSTOM_COMPATIBILITY=安装并配置自定义端点：
INSTALL_METHOD=
AUTH_CHOICE=custom-api-key
API_KEY=sk-xxxxxxxxxxxxxxxx
ENCRYPTED_API_KEY=
KEY_PAIR_ID=
MODEL_ID=qwen3.5-plus
BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
CUSTOM_PROVIDER_ID=dashscope
CUSTOM_COMPATIBILITY=openai安装完成后，可执行 OpenClawDiagnose 命令的 doctor 操作验证安装状态。
OpenClawModel：模型管理
管理已配置的模型：查询列表、查看状态、切换默认模型、添加供应商。
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 | 如 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 时必填 |
BASE_URL | 自定义端点 URL | - |
CUSTOM_PROVIDER_ID | 自定义提供商 ID | - |
CUSTOM_COMPATIBILITY | API 兼容模式 | openai（默认）/ anthropic |
建议使用 ENCRYPTED_API_KEY 而非明文 API_KEY。可通过云助手命令内容加密生成加密密钥。
使用示例
查询模型列表（JSON 格式）：
ACTION=list
OUTPUT_FORMAT=json
MODEL_ID=
AUTH_CHOICE=
API_KEY=
ENCRYPTED_API_KEY=
KEY_PAIR_ID=
BASE_URL=
CUSTOM_PROVIDER_ID=
CUSTOM_COMPATIBILITY=切换默认模型：
ACTION=switch
OUTPUT_FORMAT=
MODEL_ID=modelstudio/qwen3.5-plus
AUTH_CHOICE=
API_KEY=
ENCRYPTED_API_KEY=
KEY_PAIR_ID=
BASE_URL=
CUSTOM_PROVIDER_ID=
CUSTOM_COMPATIBILITY=配置百炼 Coding Plan：
ACTION=setup
OUTPUT_FORMAT=
MODEL_ID=
AUTH_CHOICE=modelstudio-api-key-cn
API_KEY=sk-ant-xxxxxxxxxxxxxxxx
ENCRYPTED_API_KEY=
KEY_PAIR_ID=
BASE_URL=
CUSTOM_PROVIDER_ID=
CUSTOM_COMPATIBILITY=供应商列表（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） |
OpenClawChannel：消息渠道管理
配置、查询和管理消息渠道（飞书、企业微信、QQ、钉钉）。
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 含义不同 |
PARAM_SECRET | 副凭证，建议改用 ENCRYPTED_PARAM_SECRET | - |
ENCRYPTED_PARAM_SECRET | 加密副凭证 | 与 PARAM_SECRET 二选一 |
KEY_PAIR_ID | 密钥对 ID | 使用加密凭证时必填 |
OUTPUT_FORMAT | 输出格式 | json / plain |
PROBE | 探测凭证有效性（仅 status） | true / false（默认） |
建议使用 ENCRYPTED_PARAM_SECRET 而非明文 PARAM_SECRET。可通过云助手命令内容加密生成加密凭证。
使用示例
查看连接状态（含凭证探测）：
ACTION=status
CHANNEL_TYPE=
PARAM_ID=
PARAM_SECRET=
ENCRYPTED_PARAM_SECRET=
KEY_PAIR_ID=
OUTPUT_FORMAT=json
PROBE=true配置钉钉 Channel（明文凭证）：
ACTION=setup
CHANNEL_TYPE=dingtalk
PARAM_ID=cli_xxxxxxxxxxxxxxxx
PARAM_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ENCRYPTED_PARAM_SECRET=
KEY_PAIR_ID=
OUTPUT_FORMAT=
PROBE=配置钉钉 Channel（加密凭证）：
ACTION=setup
CHANNEL_TYPE=dingtalk
PARAM_ID=
PARAM_SECRET=
ENCRYPTED_PARAM_SECRET=AQICAHh...base64...==
KEY_PAIR_ID=key-pair-12345678
OUTPUT_FORMAT=
PROBE=获取钉钉 Channel 配置：
ACTION=get
CHANNEL_TYPE=dingtalk
PARAM_ID=
PARAM_SECRET=
ENCRYPTED_PARAM_SECRET=
KEY_PAIR_ID=
OUTPUT_FORMAT=json
PROBE=禁用钉钉 Channel：
ACTION=remove
CHANNEL_TYPE=dingtalk
PARAM_ID=
PARAM_SECRET=
ENCRYPTED_PARAM_SECRET=
KEY_PAIR_ID=
OUTPUT_FORMAT=
PROBE=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 |
OpenClawGateway：Gateway 管理
管理 Gateway 服务的启停、安装/卸载、后台运行和 Dashboard 访问。
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） | - |
使用示例
重启 Gateway：
ACTION=restart
PORT=
BIND=
FORCE=
DEEP=
OUTPUT_FORMAT=
TIMEOUT=查看状态（JSON，深度扫描）：
ACTION=status
PORT=
BIND=
FORCE=
DEEP=true
OUTPUT_FORMAT=json
TIMEOUT=15后台运行（容器或非 systemd 环境）：
ACTION=run
PORT=18789
BIND=loopback
FORCE=true
DEEP=
OUTPUT_FORMAT=
TIMEOUT=获取 Dashboard URL：
ACTION=dashboard
PORT=
BIND=
FORCE=
DEEP=
OUTPUT_FORMAT=
TIMEOUT=OpenClawDiagnose：诊断维护
执行健康检查、查看系统状态、自动修复常见问题。
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） | - |
使用示例
健康检查并自动修复：
ACTION=doctor
FIX=true
DEEP=true
OUTPUT_FORMAT=
ALL=
TIMEOUT=查看完整系统状态（JSON）：
ACTION=status
FIX=
DEEP=true
OUTPUT_FORMAT=json
ALL=true
TIMEOUT=15UninstallOpenClaw：卸载清理
卸载 OpenClaw。优先检测并删除云助手插件，如未通过插件安装则执行 npm uninstall -g openclaw。
参数说明
参数 | 必填 | 说明 |
REMOVE_WORKDIR | 选填 | 是否删除工作目录 ~/.openclaw。true：清除所有配置数据；false（默认）：保留配置，方便重装 |
使用示例
仅卸载（保留配置）：
REMOVE_WORKDIR=完全卸载（清除配置数据）：
REMOVE_WORKDIR=true