1 Windows安装Openclaw
OpenClaw在linux/macOS安装都很简单不过多进行赘述。Windows官方推荐的安装方式是在windows上安装一个linux的子系统，该子系统类似于vmware的linux虚拟机，但是是windows自带的支持安装子系统的功能
1.1 安装 WSL
WSL 允许你在 Windows 上直接运行 Linux 发行版。以下是安装 WSL2 的标准步骤：
- 启用 WSL 功能： 以管理员身份打开 PowerShell 或命令提示符，输入以下命令：
wsl --install
该命令会自动启用必要的 Windows 功能，并默认安装 Ubuntu 发行版。如果想指定版本，按照如下命令wsl --install --d <发行版本名称>，如wsl --install --d Ubuntu-22.04
2. 重启电脑： 执行完上述命令后，系统会提示重启。请保存工作并重启计算机。
3. 初始化 Linux 环境： 重启后，系统会自动弹出 Ubuntu 窗口。你需要设置 Linux 的用户名和密码（输入密码时不会显示字符，输完回车即可）。
4. 验证安装： 在 PowerShell 中输入：
wsl --list --verbose
如果看到 VERSION 列为 2，说明 WSL2 安装成功。
1.2 迁移 WSL 到非系统盘
默认情况下，WSL 的虚拟磁盘文件（ext4.vhdx）会占用 C 盘空间。随着项目增多，C 盘容易爆满。建议将其迁移到空间更大的磁盘（如 D 盘）。
- 查看当前发行版名称：
wsl --list --verbose
假设名称为 Ubuntu。
2. 导出系统镜像： 在 D 盘创建一个文件夹用于存放镜像，例如 D:\WSL\Ubuntu。然后在 PowerShell 中执行：
wsl --export Ubuntu D:\WSL\Ubuntu\ubuntu.tar
3.注意：导出时间取决于已安装软件的大小，请耐心等待。*
4. 注销原系统：
警告：此操作会删除 C 盘原有的 WSL 实例，请确保上一步导出成功。
wsl --unregister Ubuntu
- 导入到新位置： 创建一个用于存放新系统文件的目标文件夹，例如
D:\WSL\Ubuntu-System。执行导入：
wsl --import Ubuntu D:\WSL\Ubuntu-System D:\WSL\Ubuntu\ubuntu.tar
- 恢复默认用户： 导入后的系统默认会以
root用户登录。你需要修改配置文件以恢复为普通用户。 在 WSL 终端中编辑/etc/wsl.conf：
sudo vim /etc/wsl.conf
添加以下内容（假设你的用户名是 user）：
[user]
default=user
保存退出后，在 PowerShell 中重启 WSL：
wsl --terminate Ubuntu
wsl -d Ubuntu
此时登录即为普通用户，且数据已位于 D 盘。
1.3 安装 OpenCLAW
进入 WSL 环境后，开始安装 OpenCLAW。通常此类工具需要基础依赖（如 git, python, make 等）。
- 更新软件源并安装基础依赖：
sudo apt update
sudo apt install -y git build-essential python3-pip curl
- 获取 OpenCLAW 源码或安装包：
- 方式 A（推荐）：从 Git 仓库推荐方法
npm install -g openclaw@latest
```如果该方法出现警告node版本过低，请将node版本更新至22或24.
* **方式 B**：curl
curl -fsSL https://openclaw.ai/install.sh | bash -s – --install-method git
3. **验证安装**： 输入以下命令检查版本，若输出版本号则安装成功：
openclaw --version
---
## 2 通用 OpenCLAW 常用命令
安装完成后，以下是 OpenCLAW 在日常使用中可能涉及到的通用命令模式。大多数命令行工具都遵循类似的逻辑。
|命令|说明|示例|
| --- | --- | --- |
|**帮助查询**|查看可用命令及参数说明|`openclaw --help` 或 `openclaw -h`|
|**版本检查**|确认当前安装的版本号|`openclaw --version` 或 `openclaw -v`|
|**初始化配置**|生成默认配置文件或初始化环境|`openclaw init`|
|**运行任务**|执行核心功能或处理文件|`openclaw run -i input.txt -o output.txt`|
|**状态监控**|查看当前运行状态或日志|`openclaw status` 或 `openclaw logs`|
|**清理缓存**|清除临时文件或重置环境|`openclaw clean`|
|**更新工具**|检查并更新到最新版本|`openclaw update`|
#### 常用场景示例
1. **查看帮助文档** 当你忘记具体参数时，使用 help 命令是最快的方法：
openclaw --help
2. **处理特定文件** 假设 OpenCLAW 用于处理数据文件，常用 `-i` (input) 和 `-o` (output) 参数：
openclaw run -i ./data/source.csv -o ./data/result.json
3. **配置环境变量** 如果工具需要 API Key 或特定路径，通常可以通过 export 设置：
export OPENCLAW_KEY=“your_api_key”
openclaw run
---
#### 结语
通过 WSL 在 Windows 上部署 OpenCLAW，既保留了 Windows 的易用性，又获得了 Linux 原生的开发体验。特别是将 WSL 迁移到非系统盘后，可以有效避免 C 盘空间焦虑。希望本文能帮助你顺利搭建环境并高效使用 OpenCLAW。
> **提示**：如果在安装过程中遇到权限问题（Permission Denied），请检查是否在命令前加了 `sudo`，或者当前用户是否在 `docker` 或 `sudo` 用户组中。