跳转到主要内容
需要帮助？
在 Discord 提问提交 GitHub Issue支持指南
这条设置路线面向 Windows 用户。除非后续步骤特别说明，OpenClaw 工作坊命令应在 WSL2 的 Ubuntu 中运行。

​
安装或检查 WSL2

打开 PowerShell 并检查当前 WSL 状态： 
wsl --status
wsl -l -v
你应该看到 Ubuntu 正在 WSL version 2 上运行： 
  NAME      STATE           VERSION
* Ubuntu    Running         2
如果 Ubuntu 已安装但仍是 WSL1，转换到 WSL2： 
wsl --set-version Ubuntu 2
如果还没有 WSL，请以 Administrator 身份运行 PowerShell 并安装： 
wsl --install

​
进入 Ubuntu

从 Windows terminal 打开 Ubuntu。 从 Windows terminal 打开 Ubuntu 准备本地 binary 文件夹和 npm 全局 prefix： 
mkdir -p ~/.local ~/.local/bin ~/.npm-global/bin
npm config set prefix "$HOME/.npm-global"

​
使用 NVM 安装 Node.js

在 Ubuntu terminal 中安装并加载 nvm： 
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
安装并使用 Node 22： 
nvm install 22
nvm use 22
检查 Node 和 npm： 
node -v
npm -v

​
安装 Codex CLI

在 WSL 中全局安装 Codex： 
npm i -g @openai/codex
codex --version
然后继续阅读 账号与 Onboarding。