简介
OpenClaw(俗称"小龙虾")是一款开源的个人 AI 助手项目,由 PSPDFKit 创始人 Peter Steinberger 开发。与传统聊天 AI 不同,OpenClaw 不仅能回答问题,还能主动操作系统、访问网页、处理邮件、整理文件、发送消息等,真正实现"会动手干活的 AI"。
本文将详细介绍在 Windows、macOS 和 Linux 三大平台上安装 OpenClaw 的完整步骤,适合零基础用户快速上手。
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