跳到主要内容 OpenClaw 跨平台安装教程:Windows、macOS 与 Linux | 极客日志
JavaScript Node.js AI
OpenClaw 跨平台安装教程:Windows、macOS 与 Linux OpenClaw 是一款开源个人 AI 助手,支持操作系统自动化任务。本文提供 Windows、macOS 及 Linux 平台的详细安装指南。主要步骤包括环境准备(Node.js、Git)、使用官方脚本或 npm 全局安装、初始化配置(API Key、模型选择)及常见问题解决。支持本地模型 Ollama 集成与技能扩展,帮助用户快速部署 AI 工作流。
前言
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 脚本需要修改执行策略:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
步骤 3:执行安装脚本 复制以下命令并粘贴到 PowerShell 中,按回车执行:
iwr -useb https://openclaw.ai/install.ps1 | iex
国内用户加速版 (如果官方脚本速度慢,可使用国内镜像):
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
步骤 4:等待安装完成
检测并安装 Node.js(如果未安装)
安装 OpenClaw 核心程序
配置环境变量
安装必要的依赖
步骤 5:验证安装
2.2 方法二:手动安装(适合高级用户) 如果你已经熟悉 Node.js 环境,可以选择手动安装。
步骤 1:安装 Node.js
访问 Node.js 官网
下载 LTS 版本(推荐 v22.x)
运行安装程序,按提示完成安装
验证安装:
步骤 2:安装 Git(可选但推荐)
访问 Git 官网
下载 Windows 版本安装程序
运行安装程序,使用默认设置即可
步骤 3:全局安装 OpenClaw
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
npm config set registry https://registry.npmjs.org
步骤 4:验证安装
2.3 方法三:使用国内版 openclaw-cn 国内用户推荐使用 openclaw-cn,针对国内网络环境优化:
npm install -g openclaw-cn@latest
三、macOS 平台安装教程
3.1 方法一:使用官方一键脚本(推荐)
步骤 1:打开终端
按 Command + 空格 打开 Spotlight 搜索
输入"终端"或"Terminal"
按回车打开终端
步骤 2:执行安装脚本 curl -fsSL https://openclaw.ai/install.sh | bash
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
步骤 3:等待安装完成
Homebrew(如果未安装)
Node.js
OpenClaw 核心程序
步骤 4:验证安装
3.2 方法二:使用 Homebrew 手动安装
步骤 1:安装 Homebrew(如果未安装) /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) "
步骤 2:安装 Node.js
步骤 3:安装 Git(如果未安装)
步骤 4:全局安装 OpenClaw
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
npm config set registry https://registry.npmjs.org
步骤 5:验证安装
3.3 方法三:使用国内版 openclaw-cn npm install -g openclaw-cn@latest
四、Linux 平台安装教程
4.1 方法一:使用官方一键脚本(推荐)
步骤 1:打开终端 根据你的 Linux 发行版,使用快捷键打开终端:
Ubuntu/Debian:Ctrl + Alt + T
Fedora:Ctrl + Alt + T
其他发行版:在应用菜单中搜索"终端"
步骤 2:更新系统包管理器 sudo apt update
sudo apt upgrade -y
步骤 3:安装必要的依赖 sudo apt install -y curl git build-essential
sudo dnf install -y curl git gcc-c++ make
sudo pacman -S --needed curl git base-devel
步骤 4:执行安装脚本 curl -fsSL https://openclaw.ai/install.sh | bash
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
步骤 5:等待安装完成
Node.js(通过 nvm 或包管理器)
OpenClaw 核心程序
必要的系统依赖
步骤 6:验证安装
4.2 方法二:使用包管理器手动安装
步骤 1:安装 Node.js Ubuntu/Debian(使用 NodeSource) :
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v
npm -v
sudo dnf install -y nodejs npm
sudo pacman -S nodejs npm
步骤 2:安装 Git
步骤 3:全局安装 OpenClaw
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
npm config set registry https://registry.npmjs.org
步骤 4:配置环境变量(如果需要) 如果运行 openclaw 命令提示找不到命令,需要将 npm 全局安装路径添加到 PATH:
npm config get prefix
export PATH="$PATH :$(npm config get prefix) /bin"
source ~/.bashrc
步骤 5:验证安装
4.3 方法三:使用 nvm 安装 Node.js(推荐开发者)
步骤 1:安装 nvm(Node Version Manager) curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
步骤 2:重新加载配置文件 source ~/.bashrc
source ~/.zshrc
步骤 3:安装最新 LTS 版本的 Node.js nvm install --lts
nvm use --lts
步骤 4:全局安装 OpenClaw
步骤 5:验证安装
五、初始化配置
5.1 启动 OpenClaw openclaw onboard --install-daemon
5.2 配置向导 首次启动时,OpenClaw 会引导你完成以下配置:
选择 AI 模型提供商
OpenAI(需要 API Key)
Anthropic Claude(需要 API Key)
本地模型(如 Ollama)
其他兼容 OpenAI API 的服务
配置 API Key
设置工作目录
选择 OpenClaw 的工作目录
默认为 ~/openclaw 或 C:\Users\你的用户名\openclaw
配置技能仓库
选择是否启用社区技能
配置 ClawHub(技能市场)
5.3 测试运行 openclaw ask "你好,请介绍一下你自己"
六、常见问题与解决方案
6.1 Windows 常见问题 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
重启 PowerShell 或终端
检查环境变量 PATH 是否包含 npm 全局安装路径
手动添加路径:
$env:Path += ";$(npm config get prefix)"
npm config set registry https://registry.npmmirror.com
6.2 macOS 常见问题 sudo npm install -g openclaw
确保网络连接正常
使用国内镜像安装 Homebrew:
/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh) "
检查 Shell 配置文件(.zshrc 或 .bash_profile),确保 PATH 配置正确。
6.3 Linux 常见问题 sudo npm install -g openclaw
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
sudo apt install -y build-essential python3
sudo dnf install -y gcc-c++ make python3
6.4 通用问题
检查日志文件:~/.openclaw/logs/
重新安装:
npm uninstall -g openclaw
npm install -g openclaw
openclaw config set api.key YOUR_API_KEY
七、卸载 OpenClaw 如果需要卸载 OpenClaw,可以按照以下步骤操作:
7.1 Windows npm uninstall -g openclaw
Remove-Item -Recurse -Force $env:USERPROFILE\openclaw
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw
7.2 macOS/Linux npm uninstall -g openclaw
rm -rf ~/openclaw
rm -rf ~/.openclaw
八、进阶配置
8.1 配置本地模型(Ollama) 如果你想在本地运行 AI 模型,可以配置 Ollama:
步骤 1:安装 Ollama
步骤 2:拉取模型
步骤 3:配置 OpenClaw 使用本地模型 openclaw config set model.provider ollama
openclaw config set model.url http://localhost:11434
openclaw config set model.name llama2
8.2 配置代理 openclaw config set proxy.http http://proxy.example.com:8080
openclaw config set proxy.https http://proxy.example.com:8080
8.3 安装技能 OpenClaw 支持通过 ClawHub 安装各种技能:
openclaw skill search 飞书
openclaw skill install feishu-integration
openclaw skill list
openclaw skill uninstall feishu-integration
九、资源链接
十、总结 OpenClaw 是一款功能强大的本地 AI 助手,通过本文提供的安装教程,你应该能够在 Windows、macOS 或 Linux 平台上成功安装并配置 OpenClaw。
安装要点回顾:
Windows :推荐使用 PowerShell 一键脚本,记得先设置执行策略
macOS :推荐使用 Homebrew 或官方脚本,确保安装了 Xcode 命令行工具
Linux :根据发行版选择合适的包管理器,推荐使用 nvm 管理 Node.js 版本
下一步建议:
配置你的 AI 模型 API Key 或本地模型
探索 ClawHub 技能市场,安装你需要的技能
阅读 官方文档 了解更多高级功能
加入社区 Discord,与其他用户交流经验
如果你在安装过程中遇到问题,可以查阅官方文档或在社区寻求帮助。祝你在使用 OpenClaw 的过程中获得愉快的体验!
相关免费在线工具 RSA密钥对生成器 生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
Mermaid 预览与可视化编辑 基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
Keycode 信息 查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
Escape 与 Native 编解码 JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
JavaScript / HTML 格式化 使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
JavaScript 压缩与混淆 Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online