如何完整安装OpenClaw大龙虾机器人?
摘要:OpenClaw(大龙虾机器人)是一款本地部署的全能AI助手,可通过WhatsApp、Telegram、飞书等聊天软件实现邮件处理、日历管理、系统操作等功能,数据本地存储更隐私。本教程适配macOSLinuxWindows系统,包含基础
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
也可通过npm全局安装(备用方式):# 配置国内npm镜像(可选,加速下载)
npm config set registry https://registry.npmmirror.com
# 全局安装OpenClaw
npm install -g openclaw@latest
验证安装成功:openclaw --version
显示版本号即安装完成。
方案2:Windows系统(原生适配,避坑版)
Windows原生对OpenClaw支持较弱,需先配置Node.js环境,全程用管理员权限打开PowerShell操作:
安装Node.js v22:# 安装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
执行Windows专属安装脚本:iwr -useb https://openclaw.ai/install.ps1 | iex
若遇执行策略报错,先执行以下命令再重新安装:Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
验证安装:openclaw --version
方案3:开发者进阶安装(Git克隆源码)
适合需要自定义开发、修改源码的用户,macOS/Linux/Windows(WSL2)均可使用:
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
# 进入目录并安装依赖
cd openclaw && pnpm install && pnpm run build
# 初始化
pnpm run openclaw onboard
三、初始化配置(核心步骤)
安装完成后,执行初始化命令进入交互式配置向导,配置AI模型和基础参数:
# 通用初始化命令
openclaw onboard
# Windows新手推荐快速配置
openclaw onboard --flow quickstart
1. 风险确认
首次配置会出现风险提示:I understand this is powerful and inherently risky. Continue?,选择Yes继续。
2. 选择AI模型并配置API Key
按方向键选择常用AI模型(推荐Claude/GPT-4/阿里云百炼,国内用户优先选阿里云百炼/Kimi,访问更稳定);
粘贴提前获取的API Key(格式为sk-xxxxxxxx),回车确认;
部分模型需浏览器打开链接完成账号授权,按提示操作即可。
3. 基础功能配置
技能包(Skill):新手直接选No跳过,后续按需安装;
记忆功能(Hooks):选中session-memory(启用多轮对话记忆,避免重复说明需求),其他默认;
配置完成后,系统会自动启动Gateway网关服务,默认端口18789。
