OpenClaw 安装

本章节将指导您如何在 Windows、macOS 和 Linux 系统上安装 OpenClaw。

系统要求

• Node.js：22 及以上版本
• 操作系统：Windows 10/11（通过 WSL2）、macOS 12+、Linux（主流发行版）

Note: OpenClaw 官方强烈推荐 Windows 用户通过 WSL2 运行。

Windows 安装（通过 WSL2）

OpenClaw 在 Windows 上需要通过 WSL2（Windows Subsystem for Linux）运行。

1. 安装 WSL2

打开 PowerShell（管理员权限），执行：

wsl --install

安装完成后重启电脑，WSL2 会默认安装 Ubuntu 发行版。

2. 在 WSL2 中安装 Node.js

打开 WSL2 终端，使用 nvm 安装 Node.js：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 重新加载 shell
source ~/.bashrc

# 安装 Node.js 22
nvm install 22

# 验证版本
node --version

3. 安装 OpenClaw

npm install -g openclaw@latest

4. 引导式设置

openclaw onboard --install-daemon

向导会引导你完成 Gateway 网关、工作区、渠道和技能的配置。

命令行工具建议

推荐使用 Windows Terminal 连接 WSL2，支持多标签页和自定义配置：

# 从 Microsoft Store 安装 Windows Terminal
# 或使用 Scoop
scoop install extras/windows-terminal

macOS 安装

1. 安装 Node.js

如果尚未安装 Node.js 22+，推荐使用 Homebrew：

brew install node@22

或使用 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.zshrc
nvm install 22

2. 安装 OpenClaw

npm install -g openclaw@latest

3. 引导式设置

openclaw onboard --install-daemon

macOS 可选应用

macOS 用户可以额外安装 OpenClaw companion app，提供：

• 菜单栏快捷控制
• Voice Wake 语音唤醒 + Push-to-Talk
• WebChat + 调试工具

详情参考 OpenClaw macOS 文档。

Linux 安装

Linux 非常适合作为 OpenClaw Gateway 的远程服务器。

1. 安装 Node.js

使用 nvm 安装 Node.js 22+：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 重新加载 shell
source ~/.bashrc  # 或 source ~/.zshrc

# 安装 Node.js 22
nvm install 22

# 验证版本
node --version

2. 安装 OpenClaw

npm install -g openclaw@latest

3. 引导式设置

openclaw onboard --install-daemon

引导向导会安装 Gateway 守护进程（systemd 用户服务），使其保持后台运行。

验证安装

安装完成后，运行以下命令验证：

openclaw --version

如果正确显示版本号，说明安装成功。

更新 OpenClaw

# npm 更新（全平台通用）
npm update -g openclaw@latest

# 或使用内置更新命令
openclaw update

# 更新后运行健康检查
openclaw doctor

下一步

安装完成后，请参考 配置 OpenClaw 来连接 AwesomeAPI 服务。

Tip: 推荐通过 Cherry Studio 配置使用 OpenClaw，配置好 Cherry Studio 后添加 OpenClaw 页面即可直接使用，无需手动编辑配置文件。