OpenClaw 安装指南｜Windows、macOS、Linux、Docker 怎么选

这里不重复整本官方文档，而是先按系统、隔离需求和维护能力选择安装路径，再使用官方命令完成安装、验证和后续维护。

安装前先确认三项条件

Node.js 版本

官方文档会更新运行时要求，执行安装前应重新打开 Getting Started 和 Install Overview 核对当前支持版本。官方安装脚本在缺少所需 Node.js 时会按文档描述处理运行时配置。

模型提供商凭据

onboarding 会让你选择模型提供商并配置 API Key。优先使用测试凭据、限制额度，不要把密钥写进公开仓库或聊天记录。

数据是否会离开本机

本地运行不代表所有数据只留在本机。使用云端模型、外部消息渠道、联网工具或第三方插件时，内容可能发送到对应服务。首次任务不要使用敏感数据。

Windows、macOS、Linux、Docker 怎么选

环境	推荐起点	适合情况
Windows 普通桌面用户	Windows Hub	想要图形化安装、状态和诊断入口
Windows 命令行用户	PowerShell 或 WSL2	需要原生 CLI，或更完整的 Linux 兼容与服务管理
macOS / Linux	官方安装脚本	普通本地使用，希望走最短官方路径
VPS / 隔离环境	Docker 或 Podman	明确需要容器隔离、远程常驻或容器化运维

Windows 的当前路径以官方 Windows 文档为准。容器不是普通本地安装的必选项，需要容器时再看官方 Docker 文档。

官方安装流程

1. 安装 OpenClaw

macOS / Linux / WSL2：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

执行远程脚本前可以先打开官方安装文档阅读内容。公司设备存在安全策略时，应先确认管理员要求。

2. 运行 onboarding

openclaw onboard --install-daemon

onboarding 用于完成基础配置并按官方流程安装后台服务。先让模型、Gateway 和基础配置工作，再接真实渠道。

3. 验证 Gateway 与 Dashboard

openclaw gateway status
openclaw dashboard

Dashboard 能打开只说明基础链路工作。接入渠道、Skills 和高权限工具前，仍应单独检查权限和数据路径。

首次任务：只做可人工核对的小任务

使用公开或虚构文本，让 OpenClaw 只做摘要或要点提取。
核对结果是否可解释，日志能否定位模型和 Gateway 行为。
基础链路稳定后，一次只增加一个渠道或 Skill。
每增加一项能力，都重新确认外部服务和停止方式。

安装失败先查什么

不要反复重装覆盖现场。先依次运行：

openclaw --version
openclaw doctor
openclaw gateway status

如果提示找不到 openclaw，优先核对全局包目录与 PATH。若 Gateway 未正常运行，再结合状态与日志继续定位。

更多当前排障方式以官方安装文档为准；需要按症状继续定位时，进入站内故障排查。

安装后安全检查

在接渠道与 Skills 前，至少确认：

API Key 的权限与额度。
Gateway 的暴露范围。
测试账号与测试目录。
外发动作是否需要人工确认。
出错时如何撤销授权、停止服务和恢复配置。

未知 Skill 不要直接安装到真实工作区；接入前先完成站内安全清单。

更新：先预览再执行

openclaw update --dry-run
openclaw update

官方 updater 会根据当前安装类型执行相应更新逻辑。切换 beta、dev 等频道会改变稳定性预期；普通用户优先使用稳定频道。具体规则见 Updating。

卸载：先确认会删除什么

openclaw uninstall --dry-run --all
openclaw uninstall

不同参数的删除范围不同，执行前应备份并阅读输出，不要直接手动删除整个状态目录。具体范围见 Uninstall。

本页核验边界

本页的安装命令和文档路径已于 2026-08-16 对照 OpenClaw 官方文档核验，但没有在每一种操作系统、容器环境和云模型组合上独立完成安装实测，因此不使用“本站实测”表述。

从零开始时，先回到起步路径；已经确定要自行部署，就按本页选择一条安装路线，不要同时铺开多个环境。

搜索 OpenClaw 中文导航

OpenClaw 安装：先选 Windows、macOS、Linux 或 Docker 路径