OpenClaw Windows 启动指南

作者：CSDN博客
# OpenClaw Windows 启动指南
## 问题
当前项目在 Windows 上直接运行会遇到以下问题：
1. 构建脚本需要 bash（Windows 默认没有）
2. pnpm 模块解析问题
## 解决方案
### 方案一：安装 Git Bash（推荐）
1. 下载并安装 Git for Windows: https://git-scm.com/download/win
2. 安装完成后，打开 Git Bash 终端
3. 进入项目目录：
```bash
cd /d/BaiduNetdiskDownload/openclaw/openclaw
```
4. 安装依赖（如果还没安装）：
```bash
pnpm install
```
5. 运行项目：
```bash
pnpm start
```
或者开发模式：
```bash
pnpm dev
```
### 方案二：使用 WSL2
1. 在 Windows 上启用 WSL2 并安装 Ubuntu
2. 在 WSL2 中克隆或访问项目代码
3. 安装 Node.js 和 pnpm
4. 运行：
```bash
cd /mnt/d/BaiduNetdiskDownload/openclaw/openclaw
pnpm install
pnpm start
```
### 方案三：手动构建（临时方案）
如果已经构建了 dist 文件，可以尝试直接运行：
```powershell
cd d:\BaiduNetdiskDownload\openclaw\openclaw
$env:OPENCLAW_RUNNER_LOG="0"
node scripts/run-node.mjs
```
## 常用命令
- `pnpm start` - 启动生产环境
- `pnpm dev` - 启动开发环境（自动重载）
- `pnpm openclaw --help` - 查看帮助
- `pnpm tui` - 启动 TUI 界面
## 注意事项
1. 确保 Node.js 版本 >= 22.12.0
2. 确保使用 pnpm 10.23.0 或更高版本
3. 首次运行可能需要较长时间构建
## 故障排除
### 如果看到 "missing dist/entry.(m)js" 错误
这表示需要先构建项目。在 Git Bash 中运行：
```bash
pnpm build
```
### 如果看到 "Cannot find package 'chalk'" 错误
这是 pnpm 模块解析问题。请确保：
1. 在项目根目录运行 `pnpm install`
2. 使用 `pnpm exec` 或 `pnpm run` 来运行命令
3. 不要直接使用 `node` 运行编译后的文件
### 如果构建脚本报错 "bash not found"
在 Windows 上需要安装 Git Bash，见方案一。

原文地址：https://blog.csdn.net/weixin_42574532/article/details/158344468