OpenClaw 是一款开源个人 AI 助手项目，支持操作系统自动化任务。本文提供 Windows、macOS 和 Linux 三大平台的详细安装步骤。主要方法包括官方一键脚本、手动安装及国内镜像加速方案。安装依赖 Node.js 环境，配置过程涉及 API Key 设置、模型选择及技能仓库管理。涵盖常见问题排查与卸载流程，帮助用户快速部署本地 AI 助手。
OpenClaw（俗称"小龙虾"）是一款开源的个人 AI 助手项目，由 PSPDFKit 创始人 Peter Steinberger 开发。与传统聊天 AI 不同，OpenClaw 不仅能回答问题，还能主动操作系统、访问网页、处理邮件、整理文件、发送消息等，真正实现"会动手干活的 AI"。
本文将详细介绍在 Windows、macOS 和 Linux 三大平台上安装 OpenClaw 的完整步骤，适合零基础用户快速上手。
在开始安装之前，请确保你的电脑满足以下基本要求：
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10/11、macOS 10.15+、主流 Linux 发行版 | Windows 11、macOS 12+、Ubuntu 20.04+ |
| 内存 | 16GB | 32GB 或更高 |
| 存储空间 | 2-4GB | 10GB 以上 |
| 网络 | 稳定的互联网连接 | 高速网络 |
OpenClaw 基于 Node.js 开发，需要以下软件支持：
这是最简单快速的安装方式，适合大多数用户。
Win + X 键，选择"Windows PowerShell (管理员)'或"终端 (管理员)"首次运行 PowerShell 脚本需要修改执行策略：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
出现提示时输入 Y 并回车确认。
复制以下命令并粘贴到 PowerShell 中，按回车执行：
iwr -useb https://openclaw.ai/install.ps1 | iex
国内用户加速版（如果官方脚本速度慢，可使用国内镜像）：
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
安装过程会自动完成以下操作：
整个过程通常需要 3-8 分钟，请耐心等待。
安装完成后，运行以下命令验证：
openclaw --version
如果输出了版本号，说明安装成功！
openclaw --help
查看帮助信息，了解可用命令。
如果你已经熟悉 Node.js 环境，可以选择手动安装。
node -v
npm -v
打开 PowerShell（管理员权限），执行：
npm install -g openclaw
国内用户加速安装：
# 设置 npm 镜像源（使用淘宝镜像）
npm config set registry https://registry.npmmirror.com
# 安装 OpenClaw
npm install -g openclaw
# 恢复官方源（可选）
npm config set registry https://registry.npmjs.org
openclaw --version
国内用户推荐使用 openclaw-cn，针对国内网络环境优化：
npm install -g openclaw-cn@latest
验证安装：
openclaw-cn --version
Command + 空格 打开 Spotlight 搜索复制以下命令并粘贴到终端中，按回车执行：
curl -fsSL https://openclaw.ai/install.sh | bash
国内用户加速版：
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
脚本会自动检测系统环境并安装所需组件，包括：
openclaw --version
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后，根据提示将 Homebrew 添加到 PATH：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
brew install node
验证安装：
node -v
npm -v
brew install git
npm install -g openclaw
国内用户加速安装：
# 设置 npm 镜像源
npm config set registry https://registry.npmmirror.com
# 安装 OpenClaw
npm install -g openclaw
# 恢复官方源（可选）
npm config set registry https://registry.npmjs.org
openclaw --version
npm install -g openclaw-cn@latest
验证安装：
openclaw-cn --version
根据你的 Linux 发行版，使用快捷键打开终端：
Ctrl + Alt + TCtrl + Alt + TUbuntu/Debian：
sudo apt update
sudo apt upgrade -y
Fedora：
sudo dnf update -y
Arch Linux：
sudo pacman -Syu
Ubuntu/Debian：
sudo apt install -y curl git build-essential
Fedora：
sudo dnf install -y curl git gcc-c++ make
Arch Linux：
sudo pacman -S --needed curl git base-devel
curl -fsSL https://openclaw.ai/install.sh | bash
国内用户加速版：
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
脚本会自动安装：
openclaw --version
Ubuntu/Debian（使用 NodeSource）：
# 添加 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：
sudo dnf install -y nodejs npm
Arch Linux：
sudo pacman -S nodejs npm
Ubuntu/Debian：
sudo apt install -y git
Fedora：
sudo dnf install -y git
Arch Linux：
sudo pacman -S git
npm install -g openclaw
国内用户加速安装：
# 设置 npm 镜像源（使用淘宝镜像）
npm config set registry https://registry.npmmirror.com
# 安装 OpenClaw
npm install -g openclaw
# 恢复官方源（可选）
npm config set registry https://registry.npmjs.org
如果运行 openclaw 命令提示找不到命令，需要将 npm 全局安装路径添加到 PATH：
# 查看 npm 全局安装路径
npm config get prefix
# 将以下内容添加到 ~/.bashrc 或 ~/.zshrc
export PATH="$PATH:$(npm config get prefix)/bin"
# 重新加载配置文件
source ~/.bashrc # 或 source ~/.zshrc
openclaw --version
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc # 或 source ~/.zshrc
nvm install --lts
nvm use --lts
npm install -g openclaw
openclaw --version
安装完成后，首次使用需要进行初始化配置。
在终端或 PowerShell 中运行：
openclaw onboard --install-daemon
首次启动时，OpenClaw 会引导你完成以下配置：
~/openclaw 或 C:\Users\你的用户名\openclaw配置完成后，可以尝试运行一个简单的命令：
openclaw ask "你好，请介绍一下你自己"
问题 1：PowerShell 执行策略错误
无法加载文件，因为在此系统上禁止运行脚本
解决方案：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
问题 2：找不到 openclaw 命令
解决方案：
$env:Path += ";$(npm config get prefix)"
问题 3：npm 安装速度慢
解决方案：使用国内镜像源
npm config set registry https://registry.npmmirror.com
问题 1：权限被拒绝
解决方案：
sudo npm install -g openclaw
问题 2：Homebrew 安装失败
解决方案：
/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)"
问题 3：命令找不到
解决方案：
检查 Shell 配置文件（.zshrc 或 .bash_profile），确保 PATH 配置正确。
问题 1：权限不足
解决方案：
sudo npm install -g openclaw
或配置 npm 全局安装目录权限：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
问题 2：Node.js 版本过低
解决方案：使用 nvm 安装最新版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
问题 3：依赖包编译失败
解决方案：安装编译工具
Ubuntu/Debian：
sudo apt install -y build-essential python3
Fedora：
sudo dnf install -y gcc-c++ make python3
问题 1：网络连接失败
解决方案：
问题 2：安装后无法启动
解决方案：
~/.openclaw/logs/npm uninstall -g openclaw
npm install -g openclaw
npm cache clean --force
问题 3：API Key 配置错误
解决方案：
重新配置 API Key：
openclaw config set api.key YOUR_API_KEY
如果需要卸载 OpenClaw，可以按照以下步骤操作：
npm uninstall -g openclaw
删除配置文件和数据：
Remove-Item -Recurse -Force $env:USERPROFILE\openclaw
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw
npm uninstall -g openclaw
删除配置文件和数据：
rm -rf ~/openclaw
rm -rf ~/.openclaw
如果你想在本地运行 AI 模型，可以配置 Ollama：
访问 Ollama 官网 下载并安装。
ollama pull llama2 # 或 ollama pull mistral
openclaw config set model.provider ollama
openclaw config set model.url http://localhost:11434
openclaw config set model.name llama2
如果需要通过代理访问 OpenAI API：
openclaw config set proxy.http http://proxy.example.com:8080
openclaw config set proxy.https http://proxy.example.com:8080
OpenClaw 支持通过 ClawHub 安装各种技能：
# 搜索技能
openclaw skill search 飞书
# 安装技能
openclaw skill install feishu-integration
# 列出已安装技能
openclaw skill list
# 卸载技能
openclaw skill uninstall feishu-integration
OpenClaw 是一款功能强大的本地 AI 助手，通过本文提供的安装教程，你应该能够在 Windows、macOS 或 Linux 平台上成功安装并配置 OpenClaw。
如果你在安装过程中遇到问题，可以查阅官方文档或在社区寻求帮助。祝你在使用 OpenClaw 的过程中获得愉快的体验！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online