OpenClaw(大龙虾机器人)是一款支持本地部署的全能 AI 助手,能够对接 WhatsApp、Telegram、飞书等聊天软件,实现邮件处理、日历管理及系统操作等功能。数据本地存储特性使其在隐私保护方面表现优异。本指南适配 macOS、Linux 和 Windows 系统,涵盖基础安装、初始化配置、第三方应用对接及常见问题排查,帮助开发者快速搭建私有化 AI 工作流。
一、环境与硬件准备
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(官方推荐)
验证安装是否成功,执行:
openclaw --version
若显示版本号即表示安装完成。也可通过 npm 全局安装作为备用方式:
# 配置国内 npm 镜像(可选,加速下载)
npm config set registry https://registry.npmmirror.com
# 全局安装 OpenClaw
npm install -g openclaw@latest
打开终端,执行官方一键安装脚本(自动安装 Node.js 及所有依赖):
curl -fsSL https://openclaw.ai/install.sh | bash
方案 2:Windows(原生适配)
Windows 原生对 OpenClaw 支持较弱,需先配置 Node.js 环境,全程使用管理员权限打开 PowerShell 操作。
验证安装:
openclaw --version
若遇执行策略报错,先执行以下命令再重新安装:
Set-ExecutionPolicy ExecutionPolicy RemoteSigned -Scope CurrentUser
执行 Windows 专属安装脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex
如需管理 Node 版本,推荐安装 nvm:
# 安装 nvm
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

