企业官网建设流程全解析

上周有个朋友发消息给我，说他的工作电脑是 Windows 10 企业版 LTSC 2021，跟着一篇 OpenClaw 部署教程装到一半就卡住了。卡点非常统一：安装脚本在 PowerShell 里弹出一句“无法安全验证 WSL2 环境，请在 PowerShell 中运行 wsl --status”，然后就没有然后了。这大概是最近在 Win10 LTSC 上折腾 OpenClaw 的人最熟悉的报错。我花了两天把整套流程重新捋了一遍，从系统版本判定到 WSL2 的开启，再到 Ubuntu 里把 OpenClaw 跑起来、接上本地模型，每一步都做了记录，最后整理成这份保姆级教程。如果你手里是一台 Windows 10，或者更特殊的 Win10 LTSC，想装 OpenClaw 又不想在报错里反复打转，这篇可以直接照着做。

1. 别急着装：先弄清楚 OpenClaw 想要一个什么样的运行环境

1.1 OpenClaw 到底是做什么的

OpenClaw 是一套开源的个人 AI 助理框架。你可以把它理解成一个“胶水层”：核心任务是把大语言模型（不管是云端 API 还是本地部署的小模型）接到你的实际工具上，让它替你读文件、写笔记、跑命令、整理资料。跟单纯调 API 的脚本不一样，OpenClaw 更强调“自主完成任务”——你给它一个目标，它会自己拆分步骤、调用工具、检查结果。

它本身是基于 Node.js 的服务，但大量底层依赖和运行机制都是面向 Linux 设计的。所以在 Windows 上的官方推荐姿势，不是直接跑一个 exe，而是先在 WSL2 里装一个 Ubuntu 环境，让 OpenClaw 在 Ubuntu 里面运行。WSL2 对 Windows 用户来说是最顺手的方案：它提供一个完整的 Linux 内核，又比传统虚拟机轻得多，还能直接访问 Windows 的磁盘文件，路径是/mnt/c/...。

这里有个重要提醒：网上有部分教程会试图绕开 WSL2，直接让你用 Docker 或者完整虚拟机。OpenClaw 的安装脚本在启动时会主动检查 WSL2 状态，绕过去以后，每次启动都可能触发那个“无法安全验证 WSL2 环境”的报错，最终还是得回头处理。所以别想走捷径，老老实实把 WSL2 环境弄好，后面所有步骤都会顺很多。

1.2 为什么偏偏非得是 WSL2

有人会问：既然 OpenClaw 是 Node.js 写的，Windows 原生装上 Node.js 不就行了吗？问题在于，它的生态里有很多工具链是 Linux 优先的，比如跟 Obsidian 联动时的文件监听、跟本地模型交互时的原生库，还有一串 shell 脚本。Windows 原生环境会遇到路径分隔符、权限模型、符号链接这一类的兼容性坑，折腾下来比装一个 WSL2 更费时间。

WSL2 和 WSL1 的区别也值得多说一句。WSL1 只是一个兼容层，用 Windows 内核去翻译 Linux 系统调用，很多 Linux 原生程序跑起来会莫名其妙出问题。WSL2 是在虚拟机平台上跑一个真正的 Linux 内核，兼容性要好得多。OpenClaw 要求的严格来说是 WSL2，不是 WSL1。如果跟着旧教程把系统默认版本设成了 1，后面一样会报错。

2. Windows 10 LTSC 的适配排查：你的系统到底支持不支持

2.1 先对号入座：LTSC 2019 和 LTSC 2021 的分水岭

Win10 LTSC 有两个主力版本，很多人根本没分清就开装了。LTSC 2019 基于 1809，内部版本号是 17763；LTSC 2021 基于 21H2，内部版本号是 19044。WSL2 需要 Windows 10 版本 1903 及以上（内部版本 18362+），所以 LTSC 2019 是拿不到 WSL2 的，LTSC 2021 没问题。

怎么查？按 Win + R，输入winver，回车，看弹出的窗口里的“OS 内部版本”。17763 就是 LTSC 2019，19044 就是 LTSC 2021。

如果你的系统是 LTSC 2019，接下来的内容可以先不用往下读了。OpenClaw 要的 WSL2 在这代系统上不提供，这是系统层面的硬限制，不是配置问题。我实测过网上各种“绕过方案”，最后都会在某个环节炸回来。两个务实选择：要么重装成 LTSC 2021（IoT 企业版 LTSC 2021 也可以，同一套内核，同样支持 WSL2），要么在 Windows 上装 VirtualBox 之类的虚拟机跑一个 Ubuntu 再部署 OpenClaw。虚拟机方案也是可行的，但篇幅关系，这里不展开。

另外提一下 CPU 和硬件要求。WSL2 需要 64 位的 Windows，不支持 32 位系统；CPU 必须支持并开启虚拟化。大部分近十年的 CPU 都支持 Intel VT-x 或 AMD-V，但有些品牌机默认在 BIOS 里是关掉的，这一步检查我在第三章会说。

2.2 没有应用商店的 LTSC，怎么搞到 Ubuntu

LTSC 默认不带 Microsoft Store，这是一个大坑。WSL 安装发行版的常规路径是“从商店免费下载 Ubuntu”，在 LTSC 上这条路基本走不通。手动把 Store 装回来在 LTSC 上也很容易遇到闪退问题，我见过不少网友反馈：离线安装 App 之后打开就闪退，也没有错误记录，其实就是 LTSC 组件缺失和商店依赖冲突导致的。所以不要硬装商店。

更好的办法是完全绕开商店。如果你的系统支持wsl --install，直接用它指定发行版安装，这一步可以在 PowerShell 里完成：

wsl --install -d Ubuntu-22.04

如果提示“无法识别的命令”，说明你的系统没有集成新版 WSL 安装器，那就改用微软官方提供的 Ubuntu 离线安装包。具体方法我会在第四章详细讲。

3. 手把手启用 WSL2：控制台命令 + 内核补丁 + 开机自检

3.1 两步开启 Windows 功能

以管理员身份打开 PowerShell（开始菜单搜 PowerShell，右键选“以管理员身份运行”），执行：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

然后重启电脑。必须重启，别跳过，否则后续检测脚本大概率会报错。如果你习惯图形界面，也可以去“控制面板 > 程序 > 启用或关闭 Windows 功能”，勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”，效果一样。

3.2 安装 WSL2 内核更新包

重启后，先确认虚拟化是否打开。按 Ctrl + Shift + Esc 打开任务管理器，切到“性能”标签，看 CPU 那一栏的“虚拟化”，必须是“已启用”。如果是“已禁用”，需要进 BIOS 找 Intel VT-x（Intel 平台）或 AMD-V（AMD 平台）打开，保存重启后再继续。这一步不做，后面的wsl --set-default-version 2会一直失败。

虚拟化正常后，接下来装 WSL2 内核补丁包。虽然 LTSC 2021 的 Windows Update 可能已经集成，但手动装一次更保险。去微软官网搜“WSL2 Linux 内核更新包”，下载wsl_update_x64.msi，双击安装。这个包很小，装完不用重启，不过保险起见重启一次也没坏处。

3.3 用 PowerShell 验证 WSL2 是否真的可用

回到管理员 PowerShell，依次执行：

wsl --set-default-version 2 wsl --status wsl --list --verbose

分三种情况判断：

• wsl --set-default-version 2如果提示 “WSL 2 requires an update”，说明内核包没生效，回到上一步重装。
• wsl --status的“默认版本”一栏，应该显示为 2。
• wsl --list --verbose如果提示“没有安装的分发版”，这属于正常现象，因为还没装 Ubuntu，下一步就装。

很多教程在这一步让你打开 Microsoft Store 下载 Ubuntu，但在 LTSC 上我们不走那条路，直接看下一章。

4. 在 WSL2 里装 Ubuntu 并跑通 OpenClaw 安装

4.1 安装 Ubuntu 22.04 的两种方式

方式 A：如果你的系统支持wsl --install，直接在管理员 PowerShell 里执行：

wsl --install -d Ubuntu-22.04

等待自动下载并安装，完成后按提示启动 Ubuntu。

方式 B：wsl --install不可用时的通用做法。到微软官方下载 Ubuntu 22.04 的 appx 安装包，下载到本地后直接在管理员 PowerShell 里执行：

Add-AppxPackage -Path "C:\你的下载目录\Ubuntu.appx"

如果这个包在你系统上没办法直接添加，可以把文件后缀从.appx改成.zip，解压后里面一般会有Install.ps1。先设置 PowerShell 允许脚本运行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

再进入解压目录运行.\Install.ps1。执行完毕，Ubuntu 就出现在开始菜单里了。

第一次启动 Ubuntu 会让你创建 Linux 用户名和密码。注意：Linux 下输入密码是不显示字符的，不是没输入，输完直接回车即可。这个细节经常吓到第一次用的人。进入 Ubuntu 后先做系统更新：

sudo apt update && sudo apt upgrade -y

4.2 Node.js 版本选择和安装

OpenClaw 基于 Node.js，Node 版本直接决定它能不能跑起来。我建议用 nvm 安装，不要用 apt 默认源，apt 里的 Node 版本往往偏老，装完大概率会出现兼容性报错。在 Ubuntu 终端里执行：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

完成后重开终端，或者执行source ~/.bashrc，然后：

nvm install 20 nvm alias default 20 node -v

我这里用的是 20.x LTS，实测稳定。

顺便澄清一个常见的混淆点：网上有人搜“node.js官网下载 openclaw”，以为 Node 官网能下载 OpenClaw，其实不是。Node.js 官网下载的是 Node 运行时本身，OpenClaw 要从它自己的官方仓库拉取源码，或者通过 npm 包安装。Node.js 只是 OpenClaw 的运行底座，顺序不要搞反。

4.3 安装 OpenClaw：克隆、依赖、初始化配置

进入你打算放项目的目录：

mkdir ~/apps && cd ~/apps

把 OpenClaw 官方仓库克隆到本地，再安装依赖：

git clone <OpenClaw官方仓库地址> openclaw cd openclaw npm install

如果 npm 慢到离谱，先把源切成国内镜像：

npm config set registry https://registry.npmmirror.com

依赖装完，看仓库 README 的 Quick Start 部分，按说明执行初始化命令。不同版本初始化命令不一样，有的是npm run setup，有的是npx openclaw init。我这里用的版本是npm run setup，执行后生成配置文件（一般是.env或者 config 目录里的 yaml/json）。初始化过程会问：用哪家模型服务、填 API Key、指定数据目录。这里先随便填，第五章我会专门讲怎么接本地模型和 Obsidian。

先跑起来试试：

npm start

如果服务正常启动、终端里出现监听地址，恭喜，第一步成功。如果这个时候报 Node 版本错误，检查 nvm 是否已经切到 20。

5. 模型接入与 Obsidian 联动：让它真正开始干活

5.1 接云端模型

OpenClaw 的模型接入，绝大多数情况下走的是 OpenAI 兼容格式。以国内常碰到的阿里云百炼平台为例，开通后在控制台拿到 API Key，在配置文件里填入类似这样的内容：

provider: openai-compatible baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1 apiKey: sk-xxxxxxxx model: qwen-plus

只要接口兼容 OpenAI 格式，OpenClaw 就能用，不需要在意它是不是“真正的 OpenAI”。填好配置后重启服务，用一句“你好，介绍一下你自己”做测试。返回正常，模型通道就通了。

如果你想把 OpenClaw 部署到云服务器上做 7x24 小时运行，阿里云有免费试用名额，申请一台 Ubuntu 云主机，把 Ubuntu 里的命令原样执行一遍，再填上这里的模型配置，就等于有了一个长期在线的个人助理。Windows 端只需要通过浏览器访问它的管理界面，不用一直开着电脑。

5.2 接本地模型（Ollama + qwen2.5:3b）

不想用云端 API，或者想跑纯本地不依赖外部服务，推荐 Ollama。在 Ubuntu 里：

curl -fsSL https://ollama.com/install.sh | sh ollama pull qwen2.5:3b

Ollama 默认监听 11434 端口，自带 OpenAI 兼容接口。OpenClaw 配置改成：

provider: openai-compatible baseURL: http://localhost:11434/v1 apiKey: ollama model: qwen2.5:3b

重启 OpenClaw 就能用上本地模型。qwen2.5:3b是我测试下来在普通配置下最稳的选择，显存 4G 都能跑，速度不错，中文理解力也不差。显存更大的话可以换 7B 或 14B，效果会进一步提升。

5.3 把 Obsidian 笔记库变成它的外接记忆

OpenClaw 和 Obsidian 的整合，本质就是给它指一条通往 vault 目录的路。在配置文件里指定：

obsidian_vault: /mnt/c/Users/你的Windows用户名/Documents/MyObsidian

/mnt/c是 WSL2 访问 Windows C 盘的路径，把 Obsidian vault 路径映射进来即可。配好后，你可以对 OpenClaw 说“把今天会议纪要整理进开发笔记”，它会直接在你的 vault 里新建笔记；也可以让它“总结 vault 里所有和项目相关的文档”，把笔记库当作检索上下文来源。

注意这里有个经验：路径里最好别有空格和中文，否则个别环节会莫名报错。我一开始用了“我的笔记”目录，连 static file 读取都失败，改成英文目录后一切正常。

6. 常见报错排查：从“无法安全验证 WSL2 环境”说起

6.1 这条报错的真实意思

OpenClaw 的启动脚本在 Windows 侧执行前，会调用 PowerShell 跑wsl --status，用来确认 WSL2 是否可用。所谓“无法安全验证 WSL2 环境”，翻译成人话就是：脚本调用wsl --status之后，拿到的结果不是它期望的“默认版本为 2 且有可用发行版”，于是拒绝继续执行。它没办法告诉你具体是哪一项不对，只能丢一句“请运行wsl --status”让你自查。所以别看这几个字就慌，自己跑一遍就知道原因了。

6.2 wsl --status 输出分析与对照表

我把我遇到过的几种输出整理成表，你可以直接对照：

表格最后一行的执行策略，是另一个高频坑。很多人下载 Ubuntu 的 appx 包后卡在Install.ps1，就是因为没先改策略，脚本一执行就被拦下来。

6.3 其他安装过程中的高频报错

第一类：npm 安装时报错缺 Python 或 make。OpenClaw 部分依赖需要编译原生模块，Ubuntu 里先装一遍构建工具：

sudo apt install -y build-essential python3

装完再npm install基本就不会再报这个错了。第二类：WSL 里访问不到 Windows 文件。确认路径用的是/mnt/c/...这种 Linux 写法，不要直接写C:\...。第三类：Obsidian 联动写入失败。多半是 vault 目录在 Windows 侧权限不足，或者路径里有中文，改成纯英文目录能解决大部分问题。

还有一个我要单独拎出来说的：如果你的系统被“精简”过，比如用了各种精简工具砍掉组件再装的 LTSC，那 WSL2 能不能开就完全看运气了。LTSC 本身已经算是“长期服务版”，我不建议再在系统上做二次精简。很多群友装到一半炸掉的，根本不是 OpenClaw 的问题，而是系统缺失组件的问题。遇到这种情况，干净重装一遍原版 LTSC 2021，再按这个教程走，速度反而更快。

最后说点个人体会。这次帮朋友装 OpenClaw，我最大的感受是：卡住大家的根本不是 OpenClaw 本身，而是 Windows 侧那一堆前置条件。wsl --status这个命令看起来简单，但绝大多数人报错后根本没去执行它，而是反复换教程、换安装包，白白浪费一晚上。现在他这台机器上的 OpenClaw 已经稳定跑了两周，每天定时把 Obsidian 里零散的读书笔记整理成带标题的卡片草稿。如果你也打算拿 LTSC 当主力系统来跑 OpenClaw，记住一个顺序：先查系统版本，再开 WSL2，最后才动 OpenClaw 安装。按这个顺序走，你大概率不会踩到我朋友那个坑。