OpenClaw(大龙虾机器人)完整安装教程
OpenClaw 是一款本地部署的全能 AI 助手,支持 WhatsApp、Telegram、飞书等聊天软件,实现邮件处理、日历管理及系统操作等功能。数据本地存储,隐私性更强。本教程适配 macOS/Linux/Windows 系统,涵盖基础安装、初始化配置、聊天软件对接及常见问题解决,新手也能快速上手。
一、安装前准备
1. 系统与硬件要求
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 12+/Ubuntu 20.04+/Windows 10(需 WSL2) | macOS 14+/Ubuntu 22.04+/Windows 11 |
| 内存 | 4GB | 8GB+ |
| 磁盘空间 | 2GB 可用 | 10GB+ SSD |
| 核心依赖 | Node.js 18.0+ | Node.js v22 LTS 最新版 |
2. 必备前置资源
- AI 模型 API Key:Claude、GPT-4/5、阿里云百炼、Kimi 等兼容 OpenAI API 的模型密钥(需前往对应平台官网注册获取);
- 网络环境:建议配置国内 npm 镜像(加速依赖下载),Windows 用户需提前安装 Git(解决依赖拉取问题)。
二、分系统快速安装
方案 1:macOS/Linux 系统(官方推荐,一键安装)
打开终端,执行官方一键安装脚本(自动安装 Node.js 及所有依赖):
curl -fsSL https://openclaw.ai/install.sh | bash
验证安装成功:
openclaw --version
显示版本号即安装完成。
也可通过 npm 全局安装(备用方式):
# 配置国内 npm 镜像(可选,加速下载)
npm config set registry https://registry.npmmirror.com
# 全局安装 OpenClaw
npm install -g openclaw@latest
方案 2:Windows 系统(原生适配,避坑版)
Windows 原生对 OpenClaw 支持较弱,需先配置 Node.js 环境,全程用管理员权限打开 PowerShell 操作。
1. 安装 Node.js v22
推荐使用 nvm 管理版本:
# 安装 nvm(Node 版本管理工具)
iwr -useb https://raw.githubusercontent.com/coreybutler/nvm-windows/master/nvm-setup.exe | iex
# 安装并使用 Node.js 22
nvm install 22
nvm use 22.22.0
2. 执行安装脚本
若遇执行策略报错,先执行以下命令再重新安装:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
执行 Windows 专属安装脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex

