安装 OpenClaw 大约需要 5 分钟。 你需要 Node.js 22+、Git 和 8GB 内存。最快的方式是执行一条 npm install -g openclaw@latest 命令，然后运行设置向导。
安装 OpenClaw 前的准备
在你的机器上安装 OpenClaw 之前，请确认以下要求：
要求最低推荐内存8GB16GB存储空间10GB20GBNode.jsv22v22+（最新 LTS）操作系统Win 10（WSL2）/ macOS 12 / Ubuntu 20.04最新稳定版
即时启用 — 无需安装、无需配置、无需终端命令
全天候运行 — 7×24 小时在线，无需保持电脑开机
自动更新 — 始终运行最新版本的 OpenClaw
推荐：全局安装
这是在任何平台上最快运行 OpenClaw 的方式：
npm install -g openclaw@latest
openclaw onboard –install-daemon
设置向导将引导你完成网关、工作区、频道和技能的配置。–install-daemon 参数会设置后台服务（macOS 上为 launchd，Linux 上为 systemd），使 OpenClaw 持续运行。
设置完成后，验证安装：
openclaw doctor
替代方案：从源码编译
如果你想要完全控制或希望为 OpenClaw 做贡献，可以从源码编译。请按照以下平台特定指南操作。
在 Windows 上安装 OpenClaw
强烈建议使用 WSL2 在 Windows 上运行 OpenClaw。请先安装 WSL2，然后按照下方的 Linux 说明操作。
如果你仍然想在 Windows 上原生运行：
第 1 步：安装前置依赖
下载 Node.js v22+（LTS 版本）
下载 Git for Windows
安装 pnpm — OpenClaw 推荐的包管理器
安装后重启终端
验证安装：
node –version # 应为 v22 或更新版本
git –version
pnpm –version
第 2 步：克隆 OpenClaw 仓库
打开 PowerShell 或命令提示符并运行：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
第 3 步：安装和编译
pnpm install
pnpm ui:build
pnpm build
这将下载所有必需的包并编译项目。
第 4 步：运行设置向导
pnpm openclaw onboard –install-daemon
向导将引导你完成 OpenClaw 的配置，包括设置 AI 模型、频道和工作区。
在 macOS 上安装 OpenClaw
第 1 步：安装前置依赖
使用 Homebrew 是最简单的方式：
# 如需安装 Homebrew
/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”# 安装 Node.js 和 Git
brew install node git# 安装 pnpm
brew install pnpm
第 2 步：克隆和编译
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
第 3 步：运行设置向导
pnpm openclaw onboard –install-daemon
这将设置 launchd 服务，使 OpenClaw 自动在后台运行。
macOS 权限设置
OpenClaw 可能会请求屏幕录制和语音功能的辅助功能权限。当提示时，前往：
系统设置 > 隐私与安全 > 辅助功能
将你的终端应用添加到允许列表中。
在 Linux（Ubuntu/Debian）上安装 OpenClaw
第 1 步：安装前置依赖
# 更新包管理器
sudo apt update# 通过 NodeSource 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash –
sudo apt install -y nodejs# 安装 Git
sudo apt install -y git# 安装 pnpm
npm install -g pnpm
第 2 步：克隆和编译
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
第 3 步：运行设置向导
pnpm openclaw onboard –install-daemon
这将设置 systemd 用户服务，使 OpenClaw 在后台持续运行。
常见安装问题排查
“pnpm install” 因权限错误失败
在 Linux/macOS 上，不要对 pnpm 或 npm 使用 sudo。请改为修复权限：
mkdir ~/.npm-global
npm config set prefix ‘~/.npm-global’
export PATH=~/.npm-global/bin:$PATH
“Node 版本不支持”错误
OpenClaw 需要 Node.js 22 或更高版本：
node –version
如果你的版本较旧，请从 nodejs.org 下载最新版本，或使用 nvm 管理版本：
nvm install 22
nvm use 22
端口已被占用
另一个应用程序正在使用相同的端口。你可以：
停止冲突的应用程序
指定不同的端口：openclaw gateway –port 18790
缺少原生依赖
在 Linux 上，你可能需要额外的编译工具：
sudo apt install build-essential
运行诊断工具
OpenClaw 内置了诊断命令，可以检查你的配置：
openclaw doctor
验证安装
安装 OpenClaw 后，运行诊断工具确认一切正常：
openclaw doctor
然后用一个简单的代理命令进行测试：
openclaw agent –message “你好，你在工作吗？”
如果 OpenClaw 有响应，说明安装已完成。
更新 OpenClaw
将 OpenClaw 更新到最新版本：
如果是全局安装：
openclaw update –channel stable
如果是从源码编译：
cd openclaw
git pull origin main
pnpm install
pnpm ui:build
pnpm build
相关文章
