如何完整安装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。
阅读全文