乌龙茶少冰2026 年了，OpenClaw 在 Windows 上的本地化部署还是能让不少人折腾到怀疑人生。
倒不是工具本身设计得有多反人类，而是网上的资料几乎默认你在 Linux 或者 macOS 下操作，真正在 Windows 上从零跑通的完整流程少得可怜。我最近刚在 Windows Server 2022 和 Windows 11 两台机器上各部署了一套 OpenClaw，中间经历了命令行找不到、WSL 内核过期、模型配置报 unknown model、旧版审批文件迁移失败等一系列问题。把踩过的坑串起来之后发现，其实 Windows 本地部署 OpenClaw 的完整链路完全可以分成几步走通：先想清楚跑在什么环境，再准备系统组件，然后安装初始化，接着接模型，最后把记忆和技能配好。这篇就按这个顺序写，尽量做到你把页面往下翻的同时就能直接照做。
如果你是第一次接触 OpenClaw，也不用慌。可以把它理解成一个“有手有脚的 AI 管家”：大模型只是它的大脑，真正干活靠的是它能读写文件、执行命令、调用技能，并且把做过的事情沉淀成长期记忆。Windows 本地部署的核心，就是把这套环境在你的电脑上正确装好、让它跟你本机的模型服务或云端模型 API 打通。这篇教程适合谁？一种是刚接触 Agent 类工具、还没在 Windows 上装过 OpenClaw 的；另一种是已经装上但卡在模型接入或记忆配置的老手。下文所有路径和命令我都基于当时的稳定版本实测过，但版本迭代很快，遇到子命令对不上时先运行 openclaw --help 看一眼，基本都能解决。
1. 动手前先决定运行形态：原生进程、WSL2 还是 Docker 容器
很多人第一步就卡在“我到底该用哪种方式装”。OpenClaw 在 Windows 上并不是只有一种跑法，常见的就有三套路径，选错后面全是坑。
1.1 三种形态的差别和选择逻辑
- 原生 Windows 进程：直接在 PowerShell 里运行 OpenClaw，安装脚本或便携包都会走这条路。优点是没有虚拟机层，启动快，文件路径直观，适合大多数想在个人电脑上日常使用的用户。缺点是有少量为 Linux 设计的技能或组件跑不了，需要等官方出 Windows 版。
- WSL2 里的 Linux 进程：通过 Windows 的 Linux 子系统安装，OpenClaw 实际跑在 Ubuntu 等发行版里。优点是很多官方文档里的命令能直接复制粘贴，处理 Linux 生态的脚本更顺手，适合后续准备把配置迁移到云服务器的人。缺点是 IO 和应用感知有虚拟化损耗，新手还要额外维护一套 Linux 文件系统。
- Docker 容器：OpenClaw 官方镜像拉起来后，通过端口映射和宿主机通信。优点是可移植性最好，依赖隔离最彻底，复制到别的机器几乎零成本。缺点是在 Windows 上跑 Docker Desktop 本身又依赖 WSL2，等于多套了一层，配置模型和挂载目录时更容易出怪问题。
| 运行形态 | 上手难度 | 日常使用体验 | 迁移性 | 踩坑概率 |
|---|---|---|---|---|
| 原生 Windows 进程 | 低 | 启动快，路径直观 | 一般 | 低 |
| WSL2 Linux 进程 | 中 | 接近 Linux 服务器 | 高 | 中 |
| Docker 容器 | 高 | 隔离好但多一层网络 | 最高 | 偏高 |
我自己的建议很明确：如果只是在个人 Windows 电脑上把 OpenClaw 用起来，优先选原生 Windows 进程，这也是后文默认讲的主要路径。只有当你想在服务器上用 Docker 编排多个智能体，或者你本身已经习惯 WSL2 工作流，才需要考虑另外两种。
你可能会问，那为什么网络上搜 OpenClaw 相关教程时总能看到 WSL、Docker 的字眼？因为很多 Agent 类组件天然面向 Linux，OpenClaw 的某些技能包（比如直接操作 Linux 命令行的）确实在 WSL2 里更顺滑。但不要因为“听起来更专业”就盲目上 Docker，本地部署的第一目标是稳定可维护，不是炫技。
1.2 安装前最重要的一个认知：workspace 目录就是 Agent 的工位
无论选哪种形态，OpenClaw 初始化后都会生成一个工作区目录。以 Windows 原生运行为例，默认路径通常是：
text复制C:\Users\Administrator\.openclaw\workspace
这里要特别强调一下：这个 workspace 不是随手创建的文件夹，它是 OpenClaw 读写项目文件、执行命令时的工作目录，相当于给 Agent 划了一间独立办公室。你让它“整理桌面文件”“分析某个项目代码”，它默认只能在 workspace 范围内操作，避免它满硬盘乱跑。理解了这一点，后面遇到权限问题、文件找不到问题，第一反应就应该是去检查路径是否落在 workspace 内，而不是怀疑 Agent 傻了。
如果你用的是 WSL2 形态，初始化时可能提示的是 /root/.openclaw/workspace，这也解释了为什么网上很多人贴的截图路径长得完全不一样——不是版本差异，是运行形态差异。建议在动手前就定好使用哪个形态，省得装到一半才发现文件散落在两套系统里。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备：能少装就别乱装，重点是 PowerShell、WSL 内核和网络连通性
不少新手把 OpenClaw 当成“聊天软件”来装，结果按照某个视频教程一口气装了 JDK、Elasticsearch、Redis，最后发现根本没有用上。OpenClaw 的本地化部署，并不需要你先搭一套完整的大数据中间件栈，它只是需要一个干净、权限正确的宿主环境。
2.1 先保证 PowerShell 7 和脚本执行策略
Windows 自带的 Windows PowerShell 5.1 虽然能用，但 OpenClaw 的官方安装脚本和部分技能模块在 PowerShell 7 下更稳定。如果你还没装，我建议先通过 winget 装一个：
powershell复制winget install --id Microso