# 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，见方案一。