← 返回博客

如何安装 OpenClaw — Windows、Mac 和 Linux 完整安装指南

安装 OpenClaw 大约需要 5 分钟。 你需要 Node.js 22+、Git 和 8GB 内存。最快的方式是执行一条 npm install -g openclaw@latest 命令，然后运行设置向导。或者，使用 MyClaw.ai 的托管服务，完全跳过安装步骤。

安装 OpenClaw 前的准备

在你的机器上安装 OpenClaw 之前，请确认以下要求：

要求最低推荐内存8GB16GB存储空间10GB20GBNode.jsv22v22+（最新 LTS）操作系统Win 10（WSL2）/ macOS 12 / Ubuntu 20.04最新稳定版

方案 1：使用托管服务跳过安装

不想折腾安装？ MyClaw.ai 提供完全托管的 OpenClaw 服务——无需任何配置，几秒钟即可使用：

  • 即时启用 — 无需安装、无需配置、无需终端命令
  • 全天候运行 — 7×24 小时在线，无需保持电脑开机
  • 自动更新 — 始终运行最新版本的 OpenClaw

立即开始使用 MyClaw.ai →

方案 2：自托管 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 步：安装前置依赖

  1. 下载 Node.js v22+（LTS 版本）
  2. 下载 Git for Windows
  3. 安装 pnpm — OpenClaw 推荐的包管理器
  4. 安装后重启终端

验证安装：

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

下一步

现在 OpenClaw 已经安装好了：

省掉配置，立即运行 OpenClaw。

MyClaw 提供全托管的 OpenClaw（Clawdbot）实例 —— 始终在线，零运维。$19/月起。

如何安装 OpenClaw — Windows、Mac 和 Linux 完整安装指南 | MyClaw.ai