OpenClaw 最全本地安装指南

OpenClaw 最全本地安装指南

本文档提供完全手动的安装步骤，适用于自动脚本失败或需要完全控制安装过程的情况。本地包现下获取。

Windows 手动安装

前提条件

• Windows 10/11 或 Windows Server 2016+
• 至少 500MB 磁盘空间
• 管理员权限（部分操作需要）

步骤 1：安装 Node.js

方法 A：使用 .msi 安装包（推荐）

1. 双击安装

   • 找到文件：nodejs-installers\node-v22.22.1-x64.msi
   • 双击运行
   • 按照安装向导操作：
     • 点击 “Next”
     • 接受许可协议
     • 选择安装路径（默认：C:\Program Files\nodejs）
     • 勾选 “Automatically install the necessary tools”（可选）
     • 点击 “Install”
     • 等待安装完成
     • 点击 “Finish”

2. 验证安装

   • 打开新的命令提示符或 PowerShell（必须是新窗口）
   • 运行：

     node --version

   • 应该输出：v22.22.1
   • 运行：

     npm --version

   • 应该输出：10.x.x

方法 B：使用便携版

1. 解压 Node.js

   • 找到文件：nodejs-portable\node-v22.22.1-win-x64.zip
   • 右键点击 → 选择 “解压到…” 或 “Extract to…”
   • 解压到：C:\Tools\
   • 解压后路径应该是：C:\Tools\node-v22.22.1-win-x64\

2. 添加到 PATH（图形界面方法）

   • 按Win + X，选择 “系统”
   • 点击 “高级系统设置”
   • 点击 “环境变量”
   • 在 “用户变量” 或 “系统变量” 中找到Path
   • 点击 “编辑”
   • 点击 “新建”
   • 输入：C:\Tools\node-v22.22.1-win-x64
   • 点击 “确定” 保存所有窗口
   • 重新打开命令提示符

3. 添加到 PATH（PowerShell 方法）

   # 以管理员身份运行 PowerShell[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path","User")+";C:\Tools\node-v22.22.1-win-x64","User")

   • 重新打开 PowerShell

4. 验证

   node --version npm --version

步骤 2：安装 OpenClaw

方法 A：使用 PowerShell（推荐）

1. 打开 PowerShell

   • 按Win + X，选择 “Windows PowerShell”
   • 或右键点击 “Windows PowerShell (管理员)”

2. 进入安装包目录

   cd"解压后的目录路径"# 例如：cd "C:\Users\YourName\Downloads\openclaw-complete-with-installers"

3. 获取 npm 全局目录

   npm config get prefix

   • 记下输出的路径，例如：C:\Users\YourName\AppData\Roaming\npm

4. 解压 OpenClaw

   tar-xzf openclaw-installed.tar.gz-C$env:APPDATA\npm

   • 或者使用完整路径：

   tar-xzf openclaw-installed.tar.gz-C"C:\Users\YourName\AppData\Roaming\npm"

5. 验证安装

   openclaw--version

方法 B：使用命令提示符

1. 打开命令提示符

   • 按Win + R
   • 输入cmd
   • 按回车

2. 进入安装包目录

   cd "解压后的目录路径"

3. 获取 npm 全局目录

   npm config get prefix

   • 记下输出路径

4. 解压 OpenClaw

   tar -xzf openclaw-installed.tar.gz -C %APPDATA%\npm

5. 验证

   openclaw --version

方法 C：使用 7-Zip 手动解压

1. 安装 7-Zip（如果没有）

   • 下载：https://www.7-zip.org/
   • 安装后重启文件资源管理器

2. 解压 openclaw-installed.tar.gz

   • 右键点击openclaw-installed.tar.gz
   • 选择 “7-Zip” → “解压到当前文件夹”
   • 得到openclaw-installed.tar
   • 再次右键点击openclaw-installed.tar
   • 选择 “7-Zip” → “解压到当前文件夹”
   • 得到lib和bin文件夹

3. 获取 npm 全局目录

   • 打开 PowerShell 或命令提示符
   • 运行：npm config get prefix
   • 记下路径，例如：C:\Users\YourName\AppData\Roaming\npm

4. 复制文件

   • 打开文件资源管理器
   • 在地址栏输入：%APPDATA%\npm（按回车）
   • 将解压出的lib文件夹内容复制到这里
   • 将解压出的bin文件夹内容复制到这里
   • 如果提示合并文件夹，选择 “是”

5. 验证

   openclaw --version

步骤 3：配置 PATH（如果找不到 openclaw 命令）

图形界面方法

1. 按Win + X，选择 “系统”
2. 点击 “高级系统设置”
3. 点击 “环境变量”
4. 在 “用户变量” 中找到Path，点击 “编辑”
5. 点击 “新建”
6. 输入 npm 全局目录路径（通常是C:\Users\YourName\AppData\Roaming\npm）
7. 点击 “确定” 保存
8. 重新打开命令提示符或 PowerShell
9. 运行：openclaw --version

PowerShell 方法

# 获取 npm 全局目录$npmPrefix= npm config get prefix# 添加到 PATH[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path","User")+";$npmPrefix","User")# 重新打开 PowerShell，然后验证openclaw--version

macOS 手动安装

前提条件

• macOS 10.15 或更高版本
• 至少 500MB 磁盘空间
• 管理员权限（sudo）

步骤 1：安装 Node.js

方法 A：使用 .pkg 安装包（推荐）

1. 双击安装

   • 找到文件：nodejs-installers/node-v22.22.1.pkg
   • 双击运行
   • 按照安装向导操作：
     • 点击 “继续”
     • 接受许可协议
     • 选择安装位置（默认：/usr/local）
     • 输入管理员密码
     • 等待安装完成
     • 点击 “关闭”

2. 验证安装

   • 打开终端（Terminal）
   • 运行：

     node--version

   • 应该输出：v22.22.1
   • 运行：

     npm--version

   • 应该输出：10.x.x

方法 B：使用便携版

1. 解压 Node.js

   # 进入安装包目录cd~/Downloads/openclaw-complete-with-installers# 解压到 /usr/localsudotar-xzfnodejs-portable/node-v22.22.1-darwin-arm64.tar.gz-C/usr/local --strip-components=1

2. 验证

   node--versionnpm--version

步骤 2：安装 OpenClaw

方法 A：直接解压（推荐）

1. 打开终端

   • 按Cmd + Space，输入 “Terminal”，按回车

2. 进入安装包目录

   cd~/Downloads/openclaw-complete-with-installers# 或者你解压的实际路径

3. 解压 OpenClaw

   sudotar-xzfopenclaw-installed.tar.gz-C/usr/local

   • 输入管理员密码

4. 验证

   openclaw--version

方法 B：解压到用户目录（不需要 sudo）

1. 配置用户级 npm

   mkdir-p~/.npm-globalnpmconfigsetprefix'~/.npm-global'

2. 添加到 PATH

   echo'export PATH=~/.npm-global/bin:$PATH'>>~/.zshrcsource~/.zshrc

3. 解压 OpenClaw

   tar-xzfopenclaw-installed.tar.gz-C~/.npm-global

4. 验证

   openclaw--version

步骤 3：配置 PATH（如果找不到 openclaw 命令）

# 添加到 PATHecho'export PATH="/usr/local/bin:$PATH"'>>~/.zshrcsource~/.zshrc# 验证openclaw--version

Linux 手动安装

前提条件

• 主流 Linux 发行版（Ubuntu、Debian、CentOS、RHEL 等）
• 至少 500MB 磁盘空间
• root 或 sudo 权限

步骤 1：安装 Node.js

使用便携版

1. 解压 Node.js

   # 进入安装包目录cd~/openclaw-complete-with-installers# 解压到 /usr/localsudotar-xzfnodejs-portable/node-v22.22.1-linux-x64.tar.gz-C/usr/local --strip-components=1

2. 验证

   node--version# 输出：v22.22.1npm--version# 输出：10.x.x

步骤 2：安装 OpenClaw

方法 A：系统级安装（推荐）

1. 解压 OpenClaw

   sudotar-xzfopenclaw-installed.tar.gz-C/usr/local

2. 验证

   openclaw--version

方法 B：用户级安装

1. 配置用户级 npm

   mkdir-p~/.npm-globalnpmconfigsetprefix'~/.npm-global'

2. 添加到 PATH

   echo'export PATH=~/.npm-global/bin:$PATH'>>~/.bashrcsource~/.bashrc

3. 解压 OpenClaw

   tar-xzfopenclaw-installed.tar.gz-C~/.npm-global

4. 验证

   openclaw--version

步骤 3：配置 PATH（如果找不到 openclaw 命令）

# 添加到 PATHecho'export PATH="/usr/local/bin:$PATH"'>>~/.bashrcsource~/.bashrc# 验证openclaw--version

常见问题排查

Windows

问题 1：tar 命令不存在

解决方案：使用 7-Zip 手动解压（参见方法 C）

问题 2：找不到 openclaw 命令

检查步骤：

1. 检查 OpenClaw 是否存在

   Test-Path"$env:APPDATA\npm\node_modules\openclaw"

2. 检查可执行文件

   Test-Path"$env:APPDATA\npm\openclaw.cmd"

3. 检查 PATH

   $env:Path-split";"|Select-String"npm"

4. 手动添加到 PATH（参见步骤 3）

问题 3：权限错误

解决方案：以管理员身份运行 PowerShell 或命令提示符

问题 4：PowerShell 执行策略错误

Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser

macOS/Linux

问题 1：找不到 openclaw 命令

解决方案：

# 检查 npm 全局目录npmconfig get prefix# 添加到 PATHecho'export PATH="$(npm config get prefix)/bin:$PATH"'>>~/.zshrcsource~/.zshrc

问题 2：权限错误

解决方案 A：使用 sudo

sudotar-xzfopenclaw-installed.tar.gz-C/usr/local

解决方案 B：配置用户级 npm（参见方法 B）

问题 3：需要 Xcode Command Line Tools（macOS）

xcode-select--install

验证安装成功

运行以下命令，确保所有输出正确：

# 检查 Node.jsnode--version# 应该输出：v22.22.1# 检查 npmnpm--version# 应该输出：10.x.x# 检查 OpenClawopenclaw--version# 应该输出：OpenClaw 2026.3.8 (...)# 查看帮助openclaw--help# 应该显示 OpenClaw 命令帮助信息

完全手动安装（不使用 tar）

Windows

1. 使用 7-Zip 或 WinRAR 解压openclaw-installed.tar.gz（两次）
2. 得到lib和bin文件夹
3. 打开文件资源管理器，地址栏输入：%APPDATA%\npm
4. 将lib和bin文件夹内容复制到这里
5. 添加%APPDATA%\npm到系统 PATH
6. 重新打开命令提示符，运行openclaw --version

macOS/Linux

1. 解压 tar.gz：

   gunzip openclaw-installed.tar.gztar-xfopenclaw-installed.tar

2. 复制文件：

   sudocp-rlib/node_modules/openclaw /usr/local/lib/node_modules/sudocpbin/openclaw /usr/local/bin/sudochmod+x /usr/local/bin/openclaw

3. 验证：

   openclaw--version

卸载

Windows

1. 删除 OpenClaw：

   Remove-Item-Recurse-Force"$env:APPDATA\npm\node_modules\openclaw"Remove-Item"$env:APPDATA\npm\openclaw.cmd"

2. 卸载 Node.js：

   • 控制面板 → 程序和功能 → 卸载 Node.js

macOS/Linux

1. 删除 OpenClaw：

   sudorm-rf/usr/local/lib/node_modules/openclawsudorm/usr/local/bin/openclaw

2. 删除 Node.js：

   sudorm-rf/usr/local/lib/node_modulessudorm-rf/usr/local/bin/nodesudorm-rf/usr/local/bin/npm

技术说明

• OpenClaw 版本：2026.3.8
• Node.js 版本：22.22.1（满足 OpenClaw >= 22.12.0 要求）
• 依赖包数量：802 个（完整包含在 openclaw-installed.tar.gz 中）
• 安装包大小：153MB（OpenClaw）+ 30-84MB（Node.js）
• 完全离线：无需任何网络连接

获取更多帮助

• 自动安装脚本：查看README.md
• Windows 详细命令：查看WINDOWS-MANUAL-COMMANDS.md
• 跨平台安装指南：查看OFFLINE-INSTALL-GUIDE.md
• OpenClaw 命令参考：查看openclaw-commands.md