OpenClaw 最全本地安装指南本文档提供完全手动的安装步骤适用于自动脚本失败或需要完全控制安装过程的情况。本地包现下获取。Windows 手动安装前提条件Windows 10/11 或 Windows Server 2016至少 500MB 磁盘空间管理员权限部分操作需要步骤 1安装 Node.js方法 A使用 .msi 安装包推荐双击安装找到文件nodejs-installers\node-v22.22.1-x64.msi双击运行按照安装向导操作点击 “Next”接受许可协议选择安装路径默认C:\Program Files\nodejs勾选 “Automatically install the necessary tools”可选点击 “Install”等待安装完成点击 “Finish”验证安装打开新的命令提示符或 PowerShell必须是新窗口运行node --version应该输出v22.22.1运行npm --version应该输出10.x.x方法 B使用便携版解压 Node.js找到文件nodejs-portable\node-v22.22.1-win-x64.zip右键点击 → 选择 “解压到…” 或 “Extract to…”解压到C:\Tools\解压后路径应该是C:\Tools\node-v22.22.1-win-x64\添加到 PATH图形界面方法按Win X选择 “系统”点击 “高级系统设置”点击 “环境变量”在 “用户变量” 或 “系统变量” 中找到Path点击 “编辑”点击 “新建”输入C:\Tools\node-v22.22.1-win-x64点击 “确定” 保存所有窗口重新打开命令提示符添加到 PATHPowerShell 方法# 以管理员身份运行 PowerShell[Environment]::SetEnvironmentVariable(Path,[Environment]::GetEnvironmentVariable(Path,User);C:\Tools\node-v22.22.1-win-x64,User)重新打开 PowerShell验证node --version npm --version步骤 2安装 OpenClaw方法 A使用 PowerShell推荐打开 PowerShell按Win X选择 “Windows PowerShell”或右键点击 “Windows PowerShell (管理员)”进入安装包目录cd解压后的目录路径# 例如cd C:\Users\YourName\Downloads\openclaw-complete-with-installers获取 npm 全局目录npm config get prefix记下输出的路径例如C:\Users\YourName\AppData\Roaming\npm解压 OpenClawtar-xzf openclaw-installed.tar.gz-C$env:APPDATA\npm或者使用完整路径tar-xzf openclaw-installed.tar.gz-CC:\Users\YourName\AppData\Roaming\npm验证安装openclaw--version方法 B使用命令提示符打开命令提示符按Win R输入cmd按回车进入安装包目录cd 解压后的目录路径获取 npm 全局目录npm config get prefix记下输出路径解压 OpenClawtar -xzf openclaw-installed.tar.gz -C %APPDATA%\npm验证openclaw --version方法 C使用 7-Zip 手动解压安装 7-Zip如果没有下载https://www.7-zip.org/安装后重启文件资源管理器解压 openclaw-installed.tar.gz右键点击openclaw-installed.tar.gz选择 “7-Zip” → “解压到当前文件夹”得到openclaw-installed.tar再次右键点击openclaw-installed.tar选择 “7-Zip” → “解压到当前文件夹”得到lib和bin文件夹获取 npm 全局目录打开 PowerShell 或命令提示符运行npm config get prefix记下路径例如C:\Users\YourName\AppData\Roaming\npm复制文件打开文件资源管理器在地址栏输入%APPDATA%\npm按回车将解压出的lib文件夹内容复制到这里将解压出的bin文件夹内容复制到这里如果提示合并文件夹选择 “是”验证openclaw --version步骤 3配置 PATH如果找不到 openclaw 命令图形界面方法按Win X选择 “系统”点击 “高级系统设置”点击 “环境变量”在 “用户变量” 中找到Path点击 “编辑”点击 “新建”输入 npm 全局目录路径通常是C:\Users\YourName\AppData\Roaming\npm点击 “确定” 保存重新打开命令提示符或 PowerShell运行openclaw --versionPowerShell 方法# 获取 npm 全局目录$npmPrefix npm config get prefix# 添加到 PATH[Environment]::SetEnvironmentVariable(Path,[Environment]::GetEnvironmentVariable(Path,User);$npmPrefix,User)# 重新打开 PowerShell然后验证openclaw--versionmacOS 手动安装前提条件macOS 10.15 或更高版本至少 500MB 磁盘空间管理员权限sudo步骤 1安装 Node.js方法 A使用 .pkg 安装包推荐双击安装找到文件nodejs-installers/node-v22.22.1.pkg双击运行按照安装向导操作点击 “继续”接受许可协议选择安装位置默认/usr/local输入管理员密码等待安装完成点击 “关闭”验证安装打开终端Terminal运行node--version应该输出v22.22.1运行npm--version应该输出10.x.x方法 B使用便携版解压 Node.js# 进入安装包目录cd~/Downloads/openclaw-complete-with-installers# 解压到 /usr/localsudotar-xzfnodejs-portable/node-v22.22.1-darwin-arm64.tar.gz-C/usr/local --strip-components1验证node--versionnpm--version步骤 2安装 OpenClaw方法 A直接解压推荐打开终端按Cmd Space输入 “Terminal”按回车进入安装包目录cd~/Downloads/openclaw-complete-with-installers# 或者你解压的实际路径解压 OpenClawsudotar-xzfopenclaw-installed.tar.gz-C/usr/local输入管理员密码验证openclaw--version方法 B解压到用户目录不需要 sudo配置用户级 npmmkdir-p~/.npm-globalnpmconfigsetprefix~/.npm-global添加到 PATHechoexport PATH~/.npm-global/bin:$PATH~/.zshrcsource~/.zshrc解压 OpenClawtar-xzfopenclaw-installed.tar.gz-C~/.npm-global验证openclaw--version步骤 3配置 PATH如果找不到 openclaw 命令# 添加到 PATHechoexport PATH/usr/local/bin:$PATH~/.zshrcsource~/.zshrc# 验证openclaw--versionLinux 手动安装前提条件主流 Linux 发行版Ubuntu、Debian、CentOS、RHEL 等至少 500MB 磁盘空间root 或 sudo 权限步骤 1安装 Node.js使用便携版解压 Node.js# 进入安装包目录cd~/openclaw-complete-with-installers# 解压到 /usr/localsudotar-xzfnodejs-portable/node-v22.22.1-linux-x64.tar.gz-C/usr/local --strip-components1验证node--version# 输出v22.22.1npm--version# 输出10.x.x步骤 2安装 OpenClaw方法 A系统级安装推荐解压 OpenClawsudotar-xzfopenclaw-installed.tar.gz-C/usr/local验证openclaw--version方法 B用户级安装配置用户级 npmmkdir-p~/.npm-globalnpmconfigsetprefix~/.npm-global添加到 PATHechoexport PATH~/.npm-global/bin:$PATH~/.bashrcsource~/.bashrc解压 OpenClawtar-xzfopenclaw-installed.tar.gz-C~/.npm-global验证openclaw--version步骤 3配置 PATH如果找不到 openclaw 命令# 添加到 PATHechoexport PATH/usr/local/bin:$PATH~/.bashrcsource~/.bashrc# 验证openclaw--version常见问题排查Windows问题 1tar 命令不存在解决方案使用 7-Zip 手动解压参见方法 C问题 2找不到 openclaw 命令检查步骤检查 OpenClaw 是否存在Test-Path$env:APPDATA\npm\node_modules\openclaw检查可执行文件Test-Path$env:APPDATA\npm\openclaw.cmd检查 PATH$env:Path-split;|Select-Stringnpm手动添加到 PATH参见步骤 3问题 3权限错误解决方案以管理员身份运行 PowerShell 或命令提示符问题 4PowerShell 执行策略错误Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUsermacOS/Linux问题 1找不到 openclaw 命令解决方案# 检查 npm 全局目录npmconfig get prefix# 添加到 PATHechoexport PATH$(npm config get prefix)/bin:$PATH~/.zshrcsource~/.zshrc问题 2权限错误解决方案 A使用 sudosudotar-xzfopenclaw-installed.tar.gz-C/usr/local解决方案 B配置用户级 npm参见方法 B问题 3需要 Xcode Command Line ToolsmacOSxcode-select--install验证安装成功运行以下命令确保所有输出正确# 检查 Node.jsnode--version# 应该输出v22.22.1# 检查 npmnpm--version# 应该输出10.x.x# 检查 OpenClawopenclaw--version# 应该输出OpenClaw 2026.3.8 (...)# 查看帮助openclaw--help# 应该显示 OpenClaw 命令帮助信息完全手动安装不使用 tarWindows使用 7-Zip 或 WinRAR 解压openclaw-installed.tar.gz两次得到lib和bin文件夹打开文件资源管理器地址栏输入%APPDATA%\npm将lib和bin文件夹内容复制到这里添加%APPDATA%\npm到系统 PATH重新打开命令提示符运行openclaw --versionmacOS/Linux解压 tar.gzgunzip openclaw-installed.tar.gztar-xfopenclaw-installed.tar复制文件sudocp-rlib/node_modules/openclaw /usr/local/lib/node_modules/sudocpbin/openclaw /usr/local/bin/sudochmodx /usr/local/bin/openclaw验证openclaw--version卸载Windows删除 OpenClawRemove-Item-Recurse-Force$env:APPDATA\npm\node_modules\openclawRemove-Item$env:APPDATA\npm\openclaw.cmd卸载 Node.js控制面板 → 程序和功能 → 卸载 Node.jsmacOS/Linux删除 OpenClawsudorm-rf/usr/local/lib/node_modules/openclawsudorm/usr/local/bin/openclaw删除 Node.jssudorm-rf/usr/local/lib/node_modulessudorm-rf/usr/local/bin/nodesudorm-rf/usr/local/bin/npm技术说明OpenClaw 版本2026.3.8Node.js 版本22.22.1满足 OpenClaw 22.12.0 要求依赖包数量802 个完整包含在 openclaw-installed.tar.gz 中安装包大小153MBOpenClaw 30-84MBNode.js完全离线无需任何网络连接获取更多帮助自动安装脚本查看README.mdWindows 详细命令查看WINDOWS-MANUAL-COMMANDS.md跨平台安装指南查看OFFLINE-INSTALL-GUIDE.mdOpenClaw 命令参考查看openclaw-commands.md