需启用windows虚拟化与wsl2并配置systemd支持：1.用systeminfo确认虚拟化已开启，否则进bios启用vt-x/svm；2.管理员运行wsl --install启用wsl2；3.可选wsl --install -d ubuntu-24.04指定发行版；4.安装后必须重启；5.编辑/etc/wsl.conf启用systemd。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
一、检查并启用 Windows 虚拟化与 WSL2 功能
若 Windows 未启用虚拟化支持或 WSL2 组件缺失，OpenClaw 将无法在 WSL2 中启动 systemd 服务及运行 Gateway。需确保底层环境满足最低运行条件。
1、以管理员身份打开 PowerShell，执行：systeminfo，确认输出中包含「已检测到虚拟机监控程序」；若无，需重启进入 BIOS 启用 Intel VT-x 或 AMD SVM。
2、在 PowerShell（管理员）中运行：wsl --install，该命令将自动启用 WSL 功能、安装 Linux 内核更新包、设置 WSL2 为默认版本。
3、如需指定发行版（推荐 Ubuntu 24.04），先运行：wsl --list --online 查看可用列表，再执行：wsl --install -d Ubuntu-24.04。
4、安装完成后，必须重启计算机，否则 WSL2 无法完成初始化。
二、配置 WSL2 启用 systemd 支持
OpenClaw 的 Gateway 服务依赖 systemd 进行进程管理与自动启停，而 WSL2 默认禁用 systemd。必须显式启用，否则服务无法注册、日志无法写入 /var/log、技能（Skill）脚本无法按计划执行。
1、启动 Ubuntu 终端，执行以下命令创建 wsl.conf 配置文件：sudo tee /etc/wsl.conf > /dev/null 。
2、退出 Ubuntu，回到 Windows PowerShell（管理员），执行：wsl --shutdown 强制终止所有 WSL 实例。
3、重新启动 Ubuntu，运行：systemctl --user status；若返回活跃（active）状态及服务列表，则 systemd 已成功启用。
三、安装 Node.js 22+ 与基础构建工具
OpenClaw 主程序及 UI 构建链路强制要求 Node.js ≥22，低版本会导致 pnpm install 失败、UI:build 报错“unknown option --experimental-loader”，且部分 Skill 使用的 ESM 语法无法解析。
1、在 Ubuntu 终端中执行：curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -。
2、接着运行：sudo apt install -y nodejs 完成安装。
3、验证版本：node -v && npm -v，输出应为类似 v22.14.0 与 10.9.2 的格式。
查找并安装AgentPMT ClawHub组织账户下发布的当前规范AgentPMT技能。用于代理需要最新AgentPMT设置时。
4、安装 Git 与构建依赖：sudo apt update && sudo apt install -y git build-essential curl。
四、下载源码并完成依赖安装与构建
OpenClaw 不提供预编译二进制包，必须通过源码克隆 + pnpm 构建方式部署。直接使用 install.sh 脚本可能跳过 UI 构建步骤，导致 Web UI 无法加载静态资源。
1、进入用户主目录：cd ~。
2、克隆官方仓库：git clone https://github.com/openclaw/openclaw.git openclaw-src。
3、进入项目目录：cd openclaw-src。
4、全局安装 pnpm（若未安装）：sudo npm install -g pnpm。
5、安装项目依赖：pnpm install；该过程将自动解析 workspace 协议并安装各子包依赖。
6、构建前端 UI：pnpm ui:build；首次执行会自动安装 @vue/cli 及相关插件，生成 dist/ 目录供 Gateway 服务托管。
五、启动 OpenClaw Gateway 并验证服务状态
Gateway 是 OpenClaw 的核心网关服务，负责模型路由、技能调度、HTTP API 暴露及 Web UI 代理。仅启动 CLI 或执行 onboard 命令不等于服务已就绪，必须确认 Gateway 进程持续运行且端口监听正常。
1、在 openclaw-src 目录下执行初始化配置：pnpm run gateway:dev（开发模式，控制台实时输出日志）。
2、另开一个 Ubuntu 终端，运行：curl http://localhost:3000/health；若返回 JSON：{"status":"ok","timestamp":...}，说明 Gateway 已响应。
3、在 Windows 浏览器中访问：http://localhost:3000；页面加载成功且右上角健康状态显示绿色，即表示 Web UI 与后端通信正常。
4、如需后台常驻运行，改用：pnpm run gateway:start，该命令将通过 systemd --user 注册为用户级服务。
