一、OpenClaw 是什么?
OpenClaw 是一个自托管的个人 AI 助手,通过一个本地网关连接你常用的聊天渠道(WhatsApp、Telegram、Slack、Discord、iMessage 等),并支持语音交互、实时画布、浏览器控制、设备节点(macOS/iOS/Android)等强大功能。你可以把它想象成一个开源版的'钢铁侠 JARVIS'。
官方推荐在 WSL2(Windows Subsystem for Linux) 上运行,以获得最佳体验。本教程以 Ubuntu 22.04(WSL2)为例,同时适用于原生 Linux 系统。
二、准备工作
2.1 系统要求
- 操作系统:Windows 10/11(启用 WSL2)或 Linux(Ubuntu 20.04+)
- 内存:至少 4GB(推荐 8GB+)
- 磁盘空间:至少 2GB(用于代码和依赖)
- 网络:能够访问 GitHub 和 npm registry
2.2 安装 WSL2(Windows 用户)
以管理员身份打开 PowerShell,执行:
wsl --install
该命令会自动安装默认的 Ubuntu 发行版并启用 WSL2。安装完成后重启电脑。
重启后,打开开始菜单找到 Ubuntu 图标,首次启动会提示创建用户名和密码(请记好,后续 sudo 会用到)。
2.3 更新系统包(WSL2/Linux 通用)
在 Ubuntu 终端中执行:
sudo apt update && sudo apt upgrade -y
2.4 安装 nvm(Node 版本管理器)
nvm 可以让你轻松安装和管理多个 Node 版本,避免权限问题。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
安装完成后,重新加载配置文件:
source ~/.bashrc
验证 nvm 是否安装成功:
nvm --version
如果显示版本号(如 0.39.7),说明成功。
⚠️ 如果
nvm命令找不到,请关闭当前终端,重新打开一个新终端,或者手动执行export NVM_DIR="$HOME/.nvm"和[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"加载。
2.5 安装 Node.js 22
使用 nvm 安装并设为默认:
nvm install 22 nvm use 22 nvm alias default 22
检查版本:
node --version # 应输出 v22.x.x which node # 应指向 /home/你的用户名/.nvm/...

