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 -
重启电脑: 执行完上述命令后,系统会提示重启。请保存工作并重启计算机。
-
初始化 Linux 环境: 重启后,系统会自动弹出 Ubuntu 窗口。你需要设置 Linux 的用户名和密码(输入密码时不会显示字符,输完回车即可)。
-
验证安装: 在 PowerShell 中输入:
wsl --list --verbose如果看到
VERSION列为2,说明 WSL2 安装成功。
1.2 迁移 WSL 到非系统盘
默认情况下,WSL 的虚拟磁盘文件(ext4.vhdx)会占用 C 盘空间。随着项目增多,C 盘容易爆满。建议将其迁移到空间更大的磁盘(如 D 盘)。
-
查看当前发行版名称:
wsl --list --verbose假设名称为
Ubuntu。 -
导出系统镜像: 在 D 盘创建一个文件夹用于存放镜像,例如
D:\WSL\Ubuntu。然后在 PowerShell 中执行:wsl --export Ubuntu D:\WSL\Ubuntu\ubuntu.tar注意:导出时间取决于已安装软件的大小,请耐心等待。
-
注销原系统:
警告:此操作会删除 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
- 方式 A(推荐):从 Git 仓库推荐方法
-
验证安装: 输入以下命令检查版本,若输出版本号则安装成功:
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 |
常用场景示例
-
查看帮助文档 当你忘记具体参数时,使用 help 命令是最快的方法:
openclaw --help -
处理特定文件 假设 OpenCLAW 用于处理数据文件,常用
-i(input) 和-o(output) 参数:openclaw run -i ./data/source.csv -o ./data/result.json -
配置环境变量 如果工具需要 API Key 或特定路径,通常可以通过 export 设置:
export OPENCLAW_KEY="your_api_key" openclaw run
结语
通过 WSL 在 Windows 上部署 OpenCLAW,既保留了 Windows 的易用性,又获得了 Linux 原生的开发体验。特别是将 WSL 迁移到非系统盘后,可以有效避免 C 盘空间焦虑。希望本文能帮助你顺利搭建环境并高效使用 OpenCLAW。
提示:如果在安装过程中遇到权限问题(Permission Denied),请检查是否在命令前加了
sudo,或者当前用户是否在docker或sudo用户组中。