OpenClaw安装方法及教程指南

本文详细介绍了OpenClaw的四种主流安装方式——npm全局安装、一键脚本部署、Docker容器化运行及源码编译，覆盖从新手快速上手到开发者深度定制的全场景需求，并强调了系统兼容性、Node.js版本、磁盘路径规范与网络环境等关键前置条件，帮你避开常见坑点，轻松完成高效、稳定、可扩展的OpenClaw本地部署。

一、确认系统与环境准备

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。

今天关于《OpenClaw安装方法及教程指南》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！