openclaw安装需先确认系统环境，再选择npm全局安装、一键脚本、docker或源码编译四种方式；各方式均需满足操作系统、node.js、磁盘空间及网络要求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
一、确认系统与环境准备
OpenClaw 的安装依赖于基础运行环境是否就绪，缺失关键组件将导致后续步骤中断或失败。需提前验证操作系统版本、Node.js 存在性、磁盘空间及网络连通性。
1、检查操作系统：Windows 10（64位）及以上、macOS 12 及以上、或主流 Linux 发行版（如 Ubuntu 22.04/24.04）。
2、确认 Node.js 版本：打开终端或 PowerShell，执行 node -v，输出应为 v20.0.0 或更高；若未安装，请前往 https://nodejs.org/zh-cn/download 下载 LTS 版本。
3、预留空间：确保安装路径所在磁盘有至少 500MB 可用空间，且路径中不含中文、空格或特殊符号（例如避免使用“我的文档”或“Program Files”）。
4、网络要求：安装过程需下载依赖包与核心脚本，需稳定访问互联网；若处于企业内网，需提前配置 HTTP/HTTPS 代理或放行 443 端口。
二、使用 npm 全局安装（推荐新手）
该方式直接通过 Node.js 包管理器部署 OpenClaw 主程序，无需额外工具链，适合快速验证功能与启动本地服务。
1、打开终端（Windows：PowerShell；macOS/Linux：Terminal）。
2、执行全局安装命令：npm install -g openclaw@latest。
3、等待安装完成，过程中若出现权限错误（如 EACCES），请改用 sudo npm install -g openclaw@latest（macOS/Linux）或以管理员身份运行 PowerShell（Windows）。
4、验证安装结果：输入 openclaw --version，成功时将显示类似 2026.1.29 的版本号。
三、运行官方一键安装脚本（跨平台稳定方案）
官方维护的安装脚本可自动检测并安装 Node.js（如缺失）、配置环境变量、拉取最新依赖，大幅降低手动配置出错概率。
1、Windows 用户：以管理员身份运行 PowerShell，依次执行：
1、执行策略设置：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。
2、运行安装脚本：iwr -useb https://openclaw.ai/install.ps1 | iex。
3、若国内访问缓慢，可替换为加速地址：iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex。
2、macOS / Linux 用户：在终端中执行：
1、运行安装脚本：curl -fsSL https://openclaw.ai/install.sh | bash。
2、Mac 用户首次执行可能提示输入开机密码（输入时不显示字符，输完直接回车）。
3、脚本运行期间请勿关闭终端窗口，完成后将显示 OpenClaw installed successfully。
四、Docker 容器化部署（适合已有 Docker 环境用户）
该方式将 OpenClaw 运行于隔离容器中，避免与宿主机环境冲突，便于版本切换与资源限制，适用于服务器或 NAS 场景。
1、确保已安装 Docker Desktop（Windows/macOS）或 Docker Engine（Linux），并正常运行。
2、拉取官方镜像：docker pull openclaw/openclaw:latest。
3、创建并启动容器，挂载配置目录以持久化数据：
1、执行以下命令（含端口映射与卷挂载）：docker run -d --name openclaw -p 18789:18789 -v ~/.openclaw:/root/.openclaw openclaw/openclaw:latest。
2、查看容器状态：docker ps | grep openclaw，确认 STATUS 为 healthy 或 Up。
3、浏览器访问 http://localhost:18789 即可进入 OpenClaw Web 界面。
五、源码编译安装（面向开发者与定制需求）
该方式允许修改源码、调试逻辑、启用实验性功能或构建私有发行版，需具备基础前端开发与构建工具链知识。
1、安装 Git 与 pnpm（推荐，比 npm 更高效）：
1、Git：从 https://git-scm.com/ 下载安装。
2、pnpm：执行 npm install -g pnpm。
2、克隆仓库并进入项目目录：
1、执行：git clone https://github.com/openclaw/openclaw.git。
2、进入目录：cd openclaw。
3、安装依赖并构建：
1、执行：pnpm install。
2、执行：pnpm build。
4、启动开发服务：pnpm run start，服务默认监听 http://localhost:18789。
