一、为啥折腾 Clawdbot?
最近刷技术圈总刷到 Clawdbot(后来也叫 Moltbot),说是能搭私人 AI 助手,支持 WhatsApp、Telegram 这些常用通道,还能跑在自己设备上,不用依赖第三方服务 —— 想着拉下来测试一下功能,顺便研究一下其源码的实现。
于是拉上 GitHub 仓库https://github.com/openclaw/openclaw,打算从源码部署试试,过程里踩了不少坑,干脆整理成记录,给同样想折腾的朋友避避坑。
二、源码部署前的准备:Windows 环境优先选 WSL2
一开始想直接用 Windows CMD 部署,结果装依赖时各种报错,查仓库文档才发现 Windows 推荐用 WSL2(Ubuntu/Debian 镜像就行),后续操作全在 WSL2 里完成:
- 启用 WSL2:先在 Windows 功能里勾 '适用于 Linux 的 Windows 子系统' 和 '虚拟机平台',重启后装 Ubuntu 22.04(微软应用商店直接搜)
- 配置 WSL2:打开 Ubuntu 终端,先更系统源(换阿里源,不然后续装包巨慢),再 sudo apt update && sudo apt upgrade -y
- 装 Git:sudo apt install git,验证 git --version,避免后续拉仓库出错
我没有执行这一步,导致后面构建项目报错,后面有其他的解决方案。
三、Node.js 安装:别踩 '版本不够' 的坑
仓库文档说要 Node≥22,这里使用nvm管理环境,并切换到node最新版本。

注意:不要用22以下的,在pnpm install会报错。
四、拉取源码 & 装依赖
1、安装依赖
git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install
在安装依赖时候会报错:

问题分析
node-llama-cpp 的 postinstall 脚本失败,错误码 3221225477 通常表示:
访问冲突或权限问题或Windows 上缺少必要的构建工具
node-llama-cpp 是可选依赖,仅用于本地嵌入。如果使用远程嵌入(如 OpenAI),可忽略该错误。项目会回退到远程嵌入。故注释掉 package.json 里面的 node-llama-cpp的依赖,重新进行 pnpm install

2、构建项目
前面安装依赖没问题之后,先构建ui
pnpm ui:build


























