项目背景
Clawdbot（后称 Moltbot）支持 WhatsApp、Telegram 等通道，可运行在本地设备。本文记录从 GitHub 仓库拉取源码并部署的全过程，包含环境配置、依赖安装及常见问题排查。
GitHub 仓库地址：https://github.com/openclaw/openclaw
环境准备
Windows 环境下推荐使用 WSL2（Ubuntu/Debian 镜像）进行部署，原生 CMD 易报错。
- 启用 WSL2：在 Windows 功能中勾选'适用于 Linux 的 Windows 子系统'和'虚拟机平台'，重启后安装 Ubuntu 22.04。
- 配置 WSL2：更新系统源（建议更换为国内源），执行
sudo apt update && sudo apt upgrade -y。 - 安装 Git：执行
sudo apt install git，验证git --version。
Node.js 版本要求
仓库文档要求 Node.js ≥ 22。建议使用 nvm 管理环境并切换至最新版本。
注意：Node.js 版本低于 22 时，pnpm install 可能报错。
源码拉取与依赖安装
1. 安装依赖
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
问题分析：
若遇到 node-llama-cpp 的 postinstall 脚本失败（错误码 3221225477），通常表示访问冲突或缺少构建工具。该依赖仅用于本地嵌入，若使用远程嵌入（如 OpenAI），可忽略此错误。项目会回退到远程嵌入。
解决方案：
注释掉 package.json 中的 node-llama-cpp 依赖，重新执行 pnpm install。
2. 构建项目
先构建 UI：
pnpm ui:build
再构建主项目：
pnpm build
若在原生 Windows 上构建提示缺少 bash，可在项目的 /script 目录下创建 Node.js 版本的构建脚本 bundle-a2ui.mjs：
#!/usr/bin/env node
import { createHash } from "node:crypto";
import { promises as fs } from "node:fs";
import path from "node:path";
import { fileURLToPath } from "node:url";
{ spawn } ;
{ promisify } ;
spawnAsync = (spawn);
__filename = (..);
__dirname = path.(__filename);
= path.(__dirname, );
= path.(, );
= path.(, );
= path.(, );
= path.(, );
() {
{
stat = fs.(dir);
stat.();
} {
;
}
}
() {
}
();
