【OpenClaw 安装教程：Windows/macOS/Linux 全平台保姆级指南】

前言

OpenClaw（俗称"小龙虾"）是一款开源的个人 AI 助手项目，由 PSPDFKit 创始人 Peter Steinberger 开发。与传统聊天 AI 不同，OpenClaw 不仅能回答问题，还能主动操作系统、访问网页、处理邮件、整理文件、发送消息等，真正实现"会动手干活的 AI"。

本文将详细介绍在 Windows、macOS 和 Linux 三大平台上安装 OpenClaw 的完整步骤，适合零基础用户快速上手。

一、安装前准备

1.1 系统要求

在开始安装之前，请确保你的电脑满足以下基本要求：

配置项	最低要求	推荐配置
操作系统	Windows 10/11、macOS 10.15+、主流 Linux 发行版	Windows 11、macOS 12+、Ubuntu 20.04+
内存	16GB	32GB 或更高
存储空间	2-4GB	10GB 以上
网络	稳定的互联网连接	高速网络

1.2 必要软件

OpenClaw 基于 Node.js 开发，需要以下软件支持：

Node.js：v20.x 或更高版本（推荐 v22.x LTS 版本）
Git：用于克隆仓库和安装技能（部分功能需要）
PowerShell（Windows）：用于执行安装脚本

二、Windows 平台安装教程

2.1 方法一：使用官方一键脚本（推荐）

这是最简单快速的安装方式，适合大多数用户。

步骤 1：以管理员身份运行 PowerShell

按 Win + X 键，选择"Windows PowerShell (管理员)"或"终端 (管理员)"
如果出现用户账户控制（UAC）提示，点击"是"

步骤 2：设置执行策略

首次运行 PowerShell 脚本需要修改执行策略：

powershell 复制代码

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

出现提示时输入 Y 并回车确认。

步骤 3：执行安装脚本

复制以下命令并粘贴到 PowerShell 中，按回车执行：

powershell 复制代码

iwr -useb https://openclaw.ai/install.ps1 | iex

国内用户加速版（如果官方脚本速度慢，可使用国内镜像）：

powershell 复制代码

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

步骤 4：等待安装完成

安装过程会自动完成以下操作：

检测并安装 Node.js（如果未安装）
安装 OpenClaw 核心程序
配置环境变量
安装必要的依赖

整个过程通常需要 3-8 分钟，请耐心等待。

步骤 5：验证安装

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

powershell 复制代码

openclaw --version

如果输出了版本号，说明安装成功！

powershell 复制代码

openclaw --help

查看帮助信息，了解可用命令。

2.2 方法二：手动安装（适合高级用户）

如果你已经熟悉 Node.js 环境，可以选择手动安装。

步骤 1：安装 Node.js

访问 Node.js 官网
下载 LTS 版本（推荐 v22.x）
运行安装程序，按提示完成安装
验证安装：

powershell 复制代码

node -v
npm -v

步骤 2：安装 Git（可选但推荐）

访问 Git 官网
下载 Windows 版本安装程序
运行安装程序，使用默认设置即可

步骤 3：全局安装 OpenClaw

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

powershell 复制代码

npm install -g openclaw

国内用户加速安装：

powershell 复制代码

# 设置 npm 镜像源（使用淘宝镜像）
npm config set registry https://registry.npmmirror.com

# 安装 OpenClaw
npm install -g openclaw

# 恢复官方源（可选）
npm config set registry https://registry.npmjs.org

步骤 4：验证安装

powershell 复制代码

openclaw --version

2.3 方法三：使用国内版 openclaw-cn

国内用户推荐使用 openclaw-cn，针对国内网络环境优化：

powershell 复制代码

npm install -g openclaw-cn@latest

验证安装：

powershell 复制代码

openclaw-cn --version

三、macOS 平台安装教程

3.1 方法一：使用官方一键脚本（推荐）

步骤 1：打开终端

按 Command + 空格 打开 Spotlight 搜索
输入"终端"或"Terminal"
按回车打开终端

步骤 2：执行安装脚本

复制以下命令并粘贴到终端中，按回车执行：

bash 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash

国内用户加速版：

bash 复制代码

curl -fssl https://open-claw.org.cn/install-cn.sh | bash

步骤 3：等待安装完成

脚本会自动检测系统环境并安装所需组件，包括：

Homebrew（如果未安装）
Node.js
OpenClaw 核心程序

步骤 4：验证安装

bash 复制代码

openclaw --version

3.2 方法二：使用 Homebrew 手动安装

步骤 1：安装 Homebrew（如果未安装）

bash 复制代码

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，根据提示将 Homebrew 添加到 PATH：

bash 复制代码

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

步骤 2：安装 Node.js

bash 复制代码

brew install node

验证安装：

bash 复制代码

node -v
npm -v

步骤 3：安装 Git（如果未安装）

bash 复制代码

brew install git

步骤 4：全局安装 OpenClaw

bash 复制代码

npm install -g openclaw

国内用户加速安装：

bash 复制代码

# 设置 npm 镜像源
npm config set registry https://registry.npmmirror.com

# 安装 OpenClaw
npm install -g openclaw

# 恢复官方源（可选）
npm config set registry https://registry.npmjs.org

步骤 5：验证安装

bash 复制代码

openclaw --version

3.3 方法三：使用国内版 openclaw-cn

bash 复制代码

npm install -g openclaw-cn@latest

验证安装：

bash 复制代码

openclaw-cn --version

四、Linux 平台安装教程

4.1 方法一：使用官方一键脚本（推荐）

步骤 1：打开终端

根据你的 Linux 发行版，使用快捷键打开终端：

Ubuntu/Debian：Ctrl + Alt + T
Fedora：Ctrl + Alt + T
其他发行版：在应用菜单中搜索"终端"

步骤 2：更新系统包管理器

Ubuntu/Debian：

bash 复制代码

sudo apt update
sudo apt upgrade -y

Fedora：

bash 复制代码

sudo dnf update -y

Arch Linux：

bash 复制代码

sudo pacman -Syu

步骤 3：安装必要的依赖

Ubuntu/Debian：

bash 复制代码

sudo apt install -y curl git build-essential

Fedora：

bash 复制代码

sudo dnf install -y curl git gcc-c++ make

Arch Linux：

bash 复制代码

sudo pacman -S --needed curl git base-devel

步骤 4：执行安装脚本

bash 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash

国内用户加速版：

bash 复制代码

curl -fssl https://open-claw.org.cn/install-cn.sh | bash

步骤 5：等待安装完成

脚本会自动安装：

Node.js（通过 nvm 或包管理器）
OpenClaw 核心程序
必要的系统依赖

步骤 6：验证安装

bash 复制代码

openclaw --version

4.2 方法二：使用包管理器手动安装

步骤 1：安装 Node.js

Ubuntu/Debian（使用 NodeSource）：

bash 复制代码

# 添加 NodeSource 仓库（以 Node.js 22.x 为例）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

# 验证安装
node -v
npm -v

Fedora：

bash 复制代码

sudo dnf install -y nodejs npm

Arch Linux：

bash 复制代码

sudo pacman -S nodejs npm

步骤 2：安装 Git

Ubuntu/Debian：

bash 复制代码

sudo apt install -y git

Fedora：

bash 复制代码

sudo dnf install -y git

Arch Linux：

bash 复制代码

sudo pacman -S git

步骤 3：全局安装 OpenClaw

bash 复制代码

npm install -g openclaw

国内用户加速安装：

bash 复制代码

# 设置 npm 镜像源（使用淘宝镜像）
npm config set registry https://registry.npmmirror.com

# 安装 OpenClaw
npm install -g openclaw

# 恢复官方源（可选）
npm config set registry https://registry.npmjs.org

步骤 4：配置环境变量（如果需要）

如果运行 openclaw 命令提示找不到命令，需要将 npm 全局安装路径添加到 PATH：

bash 复制代码

# 查看 npm 全局安装路径
npm config get prefix

# 将以下内容添加到 ~/.bashrc 或 ~/.zshrc
export PATH="$PATH:$(npm config get prefix)/bin"

# 重新加载配置文件
source ~/.bashrc  # 或 source ~/.zshrc

步骤 5：验证安装

bash 复制代码

openclaw --version

4.3 方法三：使用 nvm 安装 Node.js（推荐开发者）

步骤 1：安装 nvm（Node Version Manager）

bash 复制代码

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

步骤 2：重新加载配置文件

bash 复制代码

source ~/.bashrc
# 或
source ~/.zshrc

步骤 3：安装最新 LTS 版本的 Node.js

bash 复制代码

nvm install --lts
nvm use --lts

步骤 4：全局安装 OpenClaw

bash 复制代码

npm install -g openclaw

步骤 5：验证安装

bash 复制代码

openclaw --version

五、初始化配置

安装完成后，首次使用需要进行初始化配置。

5.1 启动 OpenClaw

在终端或 PowerShell 中运行：

bash 复制代码

openclaw onboard --install-daemon

5.2 配置向导

首次启动时，OpenClaw 会引导你完成以下配置：

选择 AI 模型提供商
- OpenAI（需要 API Key）
- Anthropic Claude（需要 API Key）
- 本地模型（如 Ollama）
- 其他兼容 OpenAI API 的服务
配置 API Key
- 输入你的 API Key
- 选择默认模型
设置工作目录
- 选择 OpenClaw 的工作目录
- 默认为 ~/openclaw 或 C:\Users\你的用户名\openclaw
配置技能仓库
- 选择是否启用社区技能
- 配置 ClawHub（技能市场）

5.3 测试运行

配置完成后，可以尝试运行一个简单的命令：

bash 复制代码

openclaw ask "你好，请介绍一下你自己"

六、常见问题与解决方案

6.1 Windows 常见问题

问题 1：PowerShell 执行策略错误

复制代码

无法加载文件，因为在此系统上禁止运行脚本

解决方案：

powershell 复制代码

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

问题 2：找不到 openclaw 命令

解决方案：

重启 PowerShell 或终端
检查环境变量 PATH 是否包含 npm 全局安装路径
手动添加路径：

powershell 复制代码

$env:Path += ";$(npm config get prefix)"

问题 3：npm 安装速度慢

解决方案：使用国内镜像源

powershell 复制代码

npm config set registry https://registry.npmmirror.com

6.2 macOS 常见问题

问题 1：权限被拒绝

解决方案：

bash 复制代码

sudo npm install -g openclaw

问题 2：Homebrew 安装失败

解决方案：

确保网络连接正常
使用国内镜像安装 Homebrew：

bash 复制代码

/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)"

问题 3：命令找不到

解决方案：

检查 Shell 配置文件（.zshrc 或 .bash_profile），确保 PATH 配置正确。

6.3 Linux 常见问题

问题 1：权限不足

解决方案：

bash 复制代码

sudo npm install -g openclaw

或配置 npm 全局安装目录权限：

bash 复制代码

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

问题 2：Node.js 版本过低

解决方案：使用 nvm 安装最新版本

bash 复制代码

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts

问题 3：依赖包编译失败

解决方案：安装编译工具

Ubuntu/Debian：

bash 复制代码

sudo apt install -y build-essential python3

Fedora：

bash 复制代码

sudo dnf install -y gcc-c++ make python3

6.4 通用问题

问题 1：网络连接失败

解决方案：

检查网络连接
使用代理或 VPN
使用国内镜像源

问题 2：安装后无法启动

解决方案：

检查日志文件：~/.openclaw/logs/
重新安装：

bash 复制代码

npm uninstall -g openclaw
npm install -g openclaw

清除缓存：

bash 复制代码

npm cache clean --force

问题 3：API Key 配置错误

解决方案：

重新配置 API Key：

bash 复制代码

openclaw config set api.key YOUR_API_KEY

七、卸载 OpenClaw

如果需要卸载 OpenClaw，可以按照以下步骤操作：

7.1 Windows

powershell 复制代码

npm uninstall -g openclaw

删除配置文件和数据：

powershell 复制代码

Remove-Item -Recurse -Force $env:USERPROFILE\openclaw
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

7.2 macOS/Linux

bash 复制代码

npm uninstall -g openclaw

删除配置文件和数据：

bash 复制代码

rm -rf ~/openclaw
rm -rf ~/.openclaw

八、进阶配置

8.1 配置本地模型（Ollama）

如果你想在本地运行 AI 模型，可以配置 Ollama：

步骤 1：安装 Ollama

访问 Ollama 官网下载并安装。

步骤 2：拉取模型

bash 复制代码

ollama pull llama2
# 或
ollama pull mistral

步骤 3：配置 OpenClaw 使用本地模型

bash 复制代码

openclaw config set model.provider ollama
openclaw config set model.url http://localhost:11434
openclaw config set model.name llama2

8.2 配置代理

如果需要通过代理访问 OpenAI API：

bash 复制代码

openclaw config set proxy.http http://proxy.example.com:8080
openclaw config set proxy.https http://proxy.example.com:8080

8.3 安装技能

OpenClaw 支持通过 ClawHub 安装各种技能：

bash 复制代码

# 搜索技能
openclaw skill search 飞书

# 安装技能
openclaw skill install feishu-integration

# 列出已安装技能
openclaw skill list

# 卸载技能
openclaw skill uninstall feishu-integration

九、资源链接

官网：https://openclaw.ai
官方文档：https://docs.openclaw.ai
GitHub 仓库：https://github.com/openclaw/openclaw
技能市场：https://clawhub.com
社区 Discord：https://discord.com/invite/clawd

十、总结

OpenClaw 是一款功能强大的本地 AI 助手，通过本文提供的安装教程，你应该能够在 Windows、macOS 或 Linux 平台上成功安装并配置 OpenClaw。

安装要点回顾：

Windows：推荐使用 PowerShell 一键脚本，记得先设置执行策略
macOS：推荐使用 Homebrew 或官方脚本，确保安装了 Xcode 命令行工具
Linux：根据发行版选择合适的包管理器，推荐使用 nvm 管理 Node.js 版本

下一步建议：

配置你的 AI 模型 API Key 或本地模型
探索 ClawHub 技能市场，安装你需要的技能
阅读官方文档了解更多高级功能
加入社区 Discord，与其他用户交流经验

如果你在安装过程中遇到问题，可以查阅官方文档或在社区寻求帮助。祝你在使用 OpenClaw 的过程中获得愉快的体验！