1. 安装前的环境准备与方案选型1.1 OpenClaw 是什么为什么 Windows 上安装会“绕”先花一分钟把 OpenClaw 这个东西说清楚。OpenClaw 是腾讯开源的多智能体协作开发平台你可以把它理解成一个“智能体管家”它能调度多个 AI 智能体协同完成任务支持接入不同的模型服务OpenAI 兼容接口、NVIDIA NIM、本地 Ollama、各种云厂商模型等还能配上工具skills让智能体具备使用电脑、操作浏览器、读写文件这类实际能力。换句话说它不像普通聊天机器人那样只做问答而是围绕一个目标拆任务、调工具、跑流程。正因为它能干这么多事依赖项就不是“一个软件装完就完事”那么轻松。OpenClaw 官方推荐用 Docker 部署容器里面把运行环境、依赖库、配置文件一次性打包省去你在宿主机上折腾 Python、Node、依赖冲突的麻烦。对 Windows 用户来说装 Docker Desktop 就得先搞定 WSL2Windows Subsystem for Linux 2这一套下来安装过程就从“下载 exe 双击下一步”变成了“装 Docker、配 WSL、拉镜像、配模型、启动服务”五连跳。这篇文章就是把这五连跳拆开按 Windows 平台的实际操作顺序一步步走。适合谁看第一次接触 OpenClaw 的 Windows 用户想在自己电脑上跑起来的人以及以前装过但卡在 Docker 引擎、WSL 内核、模型配置这类环节上的朋友。看完你不仅能装完还能知道每一步为什么这么装。1.2 Windows 上安装 OpenClaw 的三条路我为什么推荐 Docker先说结论我在 Windows 上试过三种方式最终长期用的是 Docker Desktop 方案。方案 AWindows 原生直接跑Git clone 脚本安装OpenClaw 官方仓库提供了 Linux/macOS 的一键安装脚本Windows 上也可以通过 Git Bash、PowerShell 或者 WSL 里执行安装。这种方式的问题是OpenClaw 依赖一堆 Python 包、Node 工具链原生跑在 Windows 上时偶尔会遇到路径分隔符、编译依赖、环境变量不识别这类问题处理起来比较烦。方案 B虚拟机VMware/VirtualBox里装 Ubuntu再装 OpenClaw这种方式隔离性最好适合不想动 Windows 系统配置的人。但虚拟机开销大你给 VM 分配多少内存都嫌不够而且 Docker 里面再跑容器属于“嵌套虚拟化”性能打个折。如果你是 AMD/Intel 新平台嵌套虚拟化一般能用但老旧 CPU 核显直通、USB 透传这些配置会占掉不少时间。我只在需要干净实验环境时才用这个方案。方案 CDocker Desktop WSL2推荐Docker Desktop 在 Windows 上默认使用 WSL2 后端容器实际运行在轻量级 Linux 虚拟机里但用户完全感知不到文件共享、端口映射、命令行操作都跟本机一样顺滑。OpenClaw 官方镜像开箱即用升级也就是重新拉镜像的事卸载也干净不污染系统。代价是你需要装 WSL2 并保证虚拟化开启这部分下面会一步步做。所以这篇教程的主线就是方案 C把 WSL2、Docker Desktop、Git、OpenClaw 容器、模型配置串起来。1.3 安装前的软硬件清单核对在动手之前先对照这个清单检查自己的环境能省掉后面很多坑项目要求说明操作系统Windows 10 22H264 位或 Windows 11老版本 Win10 对 WSL2 支持不完整建议升级到最新补丁CPU 虚拟化BIOS/UEFI 中开启 VT-xIntel/ SVMAMD任务管理器→性能→CPU能看到“虚拟化: 已启用”就行内存建议 16GB 及以上Docker 引擎 OpenClaw 容器 WSL2 加起来占用明显8GB 会吃紧磁盘建议预留 30GB 可用空间WSL2 虚拟磁盘 Docker 镜像 OpenClaw 数据加起来不小软件Git for Windows、Docker Desktop、Windows TerminalGit 用于拉取配置和技能库Docker 是运行环境终端提升操作体验这里面最容易翻车的就是虚拟化没开。很多人装 Docker Desktop 一直提示 WSL2 kernel 错误最后发现 BIOS 里虚拟化关闭了。如果你不确定先按Ctrl Shift Esc打开任务管理器切到“性能”选项卡点“CPU”右下角看“虚拟化”那行。显示“已启用”就放心显示“已禁用”就要先去 BIOS 开这个不提前搞定后面全白搭。2. Windows 系统层配置WSL2 与必要工具链2.1 启用 WSL2执行一条命令但别忽略前提WSL2 是 Docker Desktop for Windows 的核心后端它本质上是一个轻量级虚拟机专门跑 Linux 内核让容器可以直接运行在 Linux 环境里不用像传统虚拟机那样消耗一整份完整的操作系统资源。在 Windows 11 或新版 Windows 10 上启用 WSL2 最简单的方式是以管理员身份打开 PowerShell 或 Windows Terminal执行wsl --install这条命令会帮你自动启用“适用于 Linux 的 Windows 子系统”和“虚拟机平台”两个可选组件然后安装默认的 Ubuntu 发行版再下载安装最新 WSL2 内核。执行完之后按提示重启电脑第一次启动 Ubuntu 时会要求你设置用户名和密码这个用户是 WSL 里面的 Linux 用户跟你 Windows 登录账号没关系。有几件事我要单独提醒wsl --install在部分国行机器或装了精简版系统的机器上可能会因为系统组件被精简而失败。这时候你需要手动启用组件dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart然后dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart重启后再用wsl --update手动更新内核。装完之后检查默认版本是不是 WSL2。在 PowerShell 执行wsl -l -v输出里 NAME 是 UbuntuVERSION 应该是 2。如果显示 1执行wsl --set-version Ubuntu 2WSL2 默认会占用内存微软的机制是按需分配但 Docker 跑起来后调度比较激进。建议在用户目录下建一个.wslconfig文件限制资源内容参考[wsl2] memory8GB processors4 swap4GB localhostForwardingtrue这里 memory 和 processors 按你机器实际配置改localhostForwardingtrue一定要留着这是 Windows 侧通过 localhost 访问容器内端口的关键。2.2 安装 Git 并做最小必要配置OpenClaw 安装过程、技能库skills的拉取都依赖 Git。Windows 上推荐安装 Git for Windows直接去官网下载安装包安装向导里大多数选项保持默认即可但有几个选项值得注意“Select Components”里勾上“Git Bash Here”和“Git GUI Here”后面在文件夹里右键就能打开 Git Bash很方便。“Choosing the default editor”选你顺手的VSCode 或 Vim 都行不常改代码的保持默认 Vim 也行。“Adjusting your PATH environment”选“Git from the command line and also from 3rd-party software”这样 PowerShell、CMD、WSL 里都能直接用 git 命令。“Configuring the line ending conversions”选“Checkout as-is, commit as-is”避免 Windows 和 Linux 换行符差异带来莫名其妙的问题尤其是从仓库拉取脚本时。装完验证一下git --version然后配置你的用户信息这两个配置会写进 Git 的全局配置文件OpenClaw 拉取远程仓库或提交本地修改时都会用到git config --global user.name 你的名字 git config --global user.email 你的邮箱如果你在 WSL Ubuntu 里也打算用 Git别忘在 WSL 终端里也执行一遍同样的配置。Windows 侧 Git 和 WSL 侧 Git 的配置是独立的。2.3 终端工具为什么我推荐 Windows Terminal安装过程中你会频繁用到命令行Windows 自带的 CMD 不好用PowerShell 比 CMD 强但也不算顺手。我建议你装 Windows Terminal微软商店直接搜就行。它的好处多标签页PowerShell、CMD、WSL Ubuntu、Git Bash 可以并排开不用开一堆窗口。支持 CtrlV 粘贴对新手友好。渲染速度比老终端快长日志输出不容易卡。可以自定义配色、字体显示中文没问题。装完之后把默认终端配置文件改成“Windows PowerShell”或“Ubuntu”看你自己习惯。我个人的做法是系统层面用 Windows Terminal跑 Docker 命令用 PowerShell跑 OpenClaw 交互命令行时如果遇到字符集问题就切到 WSL Ubuntu 里执行。3. Docker Desktop 安装与核心配置3.1 下载安装 Docker Desktop注意两个选项去 Docker 官网下载 Docker Desktop for Windows双击安装。安装界面上有两个关键选项要留意“Use WSL 2 instead of Hyper-V”这个必须勾上表示用 WSL2 后端性能更好且与 WSL 集成更顺。如果你不小心选了 Hyper-V后面也可以去设置里改。“Add shortcut to desktop”看个人喜好建议勾方便随时打开。安装完成后会提示注销或重启照做。重启后第一次启动 Docker Desktop它会初始化 WSL 后端可能需要几分钟。启动后会让你登录 Docker Hub 账号可以直接跳过Skip。验证安装是否成功在 PowerShell 执行docker version docker compose versiondocker version输出包含 Client 和 Server 两段如果 Server 段有信息说明引擎跑起来了。如果 Server 段是空的或提示无法连接先看 Docker Desktop 右下角鲸鱼图标是不是在运行状态右键看“Troubleshoot”有没有报错。3.2 Docker Desktop 的资源设置与国内拉取加速Docker Desktop 跑起来后进 Settings 做几项优化“General”标签里如果你在中国大陆把“Expose daemon on tcp://localhost:2375 without TLS”留着不勾保持默认安全状态。“Resources → Advanced”里给 WSL 后端分配内存和 CPU。默认是机器一半资源OpenClaw 单容器场景建议给 6GB 到 8GB 内存CPU 留 2 核以上。给太少容器会 OOM给太多会影响 Windows 本身流畅度。“Resources → WSL Integration”里确保打开“Enable integration with my default WSL distro”并且勾选你安装的 Ubuntu。这一步很重要不然你在 WSL 里执行 docker 命令会提示找不到。“Docker Engine”标签里可以改镜像加速配置如果你能直接访问 Docker Hub 官方源不用改如果拉取镜像超时建议在 JSON 配置文件里添加国内镜像加速地址。在 Docker Desktop 的 Docker Engine 配置中增加 registry-mirrors 列表即可比如{ registry-mirrors: [ https://docker.m.daocloud.io ] }改完点 Apply Restart让 Docker 引擎按新配置重启。这里提醒一句镜像加速只影响 Docker Hub 镜像拉取速度不影响 OpenClaw 本身的数据传输。3.3 检查 Docker 与 WSL 的联动是否正常我见过不少人在这一步出问题Docker Desktop 显示 Running但在 WSL Ubuntu 里执行docker ps却提示“permission denied”或“cannot connect to the Docker daemon”。先在 PowerShell 里验证docker ps如果正常再切到 WSL Ubuntu 终端里执行同样的命令。如果 WSL 里不行多半是 WSL Integration 没勾上或者当前用户不在 docker 用户组。WSL 里执行sudo usermod -aG docker $USER然后重启 WSL 终端或者干脆重启 Windows 让用户组生效。有些人改了用户组还是不行那就重启 Docker Desktop 再试。另外Docker Desktop 右下角图标如果是一直转圈或者红点去 Settings → Troubleshoot 里点“Get support”看看日志里有没有 WSL 相关的报错。最常见的原因是 Windows 版本过旧、WSL 内核没更新或者虚拟化被安全软件禁用。对应处理分别是升级系统、执行wsl --update、检查 BIOS 和安全中心。4. OpenClaw 安装与启动实操4.1 获取 OpenClaw官方脚本 vs 仓库手动拉取OpenClaw 官方推荐一条命令安装但在 Windows 上直接用官方脚本会有一个典型问题它默认面向 Linux/macOS 环境PowerShell 下执行 curl 管道脚本有时会因为执行策略Execution Policy报错或者脚本内部用到的命令在 Windows 上没有对应实现。所以我在 Windows 上的做法是先通过 Git 把仓库拉下来再手动执行安装脚本。具体步骤找一个你打算放安装文件的目录比如D:\OpenClaw在 PowerShell 里执行mkdir D:\OpenClaw cd D:\OpenClaw git clone https://github.com/open-claw/open-claw.git cd open-claw如果你访问 GitHub 比较慢可以考虑用 ghproxy 之类的加速地址但注意代理服务的安全性和时效性更稳妥的方式是直接用git clone多试几次断点续传性能还不错。查看仓库里的安装说明。通常有README.md和 install 相关脚本打开看当前版本的安装方式。OpenClaw 的安装脚本支持指定目录如果你想装到别的路径官方脚本一般带--directory或环境变量参数具体以仓库文档为准。用 PowerShell 执行安装脚本时如果提示“无法加载因为在此系统上禁止运行脚本”先执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser这是 PowerShell 的安全策略允许运行本地脚本和经过签名的远程脚本只对当前用户生效不会影响系统安全性。安装脚本执行完成后会提示你设置工作目录和配置模型服务。OpenClaw 支持多种模型后端OpenAI 兼容接口、NVIDIA NIM、Ollama 等。你可以先用 OpenAI 兼容 API 来跑通流程比如配置一个环境变量OPENAI_API_KEY指向能访问的大模型服务。如果你有 NVIDIA GPU 并想本地跑 NIMOpenClaw 有专门的 NIM 配置方式会在配置向导里让你填 endpoint 和 API key。4.2 通过 Docker 运行 OpenClaw 容器OpenClaw 仓库里带 Dockerfile 和 docker-compose.yml。如果你是用 Git 拉取的仓库直接用 docker compose 启动最省事。在仓库目录下执行docker compose up -d这个过程会构建镜像首次构建会比较久因为要拉基础镜像和安装依赖。构建完容器会以守护模式跑起来。查看状态docker compose ps看到状态是 Up 就说明起来了。日志查看docker compose logs -f这时候你可能会在日志里看到模型服务的连接信息以及启动后的端口监听信息。OpenClaw 的 Web 界面或交互面板一般会监听某个本地端口比如 8080 或 3000 之类的具体看日志输出和配置样例。浏览器访问http://localhost:端口应该能看到 OpenClaw 的控制面板。如果你不想通过源码仓库构建也可以用官方发布的 Docker 镜像直接跑这样升级时只要重新拉取镜像就行。命令形如docker run -d --name openclaw -p 8080:8080 \ -v /d/OpenClaw/data:/data \ -e OPENAI_API_KEY你的key \ openclaw/openclaw:latest注意 Windows 上路径挂载的写法跟 Linux 不一样主机路径D:\OpenClaw\data在 Git Bash 里可以写/d/OpenClaw/data在 PowerShell 里直接写D:/OpenClaw/data也可以。如果你不确定先创建一个目录放数据避免容器删除后配置全丢。4.3 配置模型后端与核心参数OpenClaw 启动后第一件事就是确认模型服务能连通。配置文件通常是一个.env或config.yaml里面需要指定模型服务地址endpoint比如你用的是 NVIDIA NIM那就是 NIM 网关的地址和端口用的是 OpenAI 兼容服务就是对应服务的 API 地址。API Key必须配好不然请求会被拒。默认模型名称比如meta-llama-3.3-70b-instruct、gpt-4o-mini或你服务里支持的模型名。温度、最大 token 等生成参数这些可以留默认值OpenClaw 在智能体任务中会按需覆盖。我的建议是先用最简单的对话场景验证连通性再逐步加技能、加工具。不要一上来就配置复杂的 skills 和 computer use先把基础链路跑通再考虑扩展。具体到 OpenClaw 2.0 上的配置有些版本支持通过管理界面点选配置有些版本必须改 yaml 文件你先确认自己拉取的版本是哪种。有一个新手容易忽略的点OpenClaw 容器里的时钟和时区。如果你启动容器后日志时间不对很多定时任务、调度逻辑会判断失误。可以在 docker run 命令里加环境变量TZAsia/Shanghai或者通过 docker-compose 的 environment 配置项指定。4.4 启动后的验证清单启动完成不代表万事大吉我每次新装完都会按这个清单过一遍访问 Web 界面或命令行交互界面能正常响应。用一句话任务测试模型连通性比如“你好介绍一下你自己”确认模型返回结果。尝试让 OpenClaw 执行一个简单的多步任务比如“搜索一个话题并整理要点”观察日志中智能体是否按步骤执行、是否有报错。确认数据目录有写入说明容器内的数据持久化正常。重启 Docker Desktop 后容器能自动恢复取决于 docker-compose 的 restart 策略或者你手动启动一次确认没有严重 bug。如果第 2 步就卡住绝大多数时候问题都出在 API Key 填错、模型名不对、网络不通这三件事上。按“日志优先”原则去查OpenClaw 日志会明确告诉你请求发到哪个地址、返回什么错误。5. 常见问题与排查技巧实录5.1 安装过程高频报错速查表现象直接原因解决方式wsl --install 执行失败系统组件被精简或版本过旧手动启用两个可选组件再用 wsl --update 更新内核Docker Desktop 启动后一直转圈WSL2 内核版本不匹配执行 wsl --update重启 Docker Desktopdocker ps 在 WSL 里提示连接不上WSL Integration 没开启Docker Desktop Settings → Resources → WSL Integration 勾选对应发行版容器启动后立即退出配置文件中模型服务地址不可达查看 docker logs确认模型服务地址和端口能从容器内访问镜像拉取超时Docker Hub 连接不稳定配置 registry-mirrors 或使用代理策略不在本文讨论范围PowerShell 执行安装脚本提示禁止运行执行策略限制Set-ExecutionPolicy RemoteSigned -Scope CurrentUser容器内时间不对未设置 TZ 环境变量在 compose 文件环境变量中加 TZAsia/ShanghaiOpenClaw 界面能打开但任务无响应模型 API Key 无效或额度不足检查控制台日志中的 HTTP 状态码确认 Key 有效端口被占用本机其他程序占用了默认端口修改 docker-compose 的端口映射或用 docker ps 查看已占用端口5.2 我踩过的三个 Windows 专属坑坑一文件路径里的反斜杠在 Windows 上执行 docker run 挂载目录时我一开始用的是 PowerShell 原生写法-v D:\OpenClaw\data:/data结果 Docker 把反斜杠当成了转义字符容器里看到的路径完全不对。解决办法是改用正斜杠D:/OpenClaw/data或者用 Git Bash 里的/d/OpenClaw/data写法。如果你用 docker-composeyaml 文件里路径统一用正斜杠。坑二杀毒软件拦截 WSL 虚拟化我在一台装了第三方安全软件的机器上装 DockerWSL2 始终无法启动日志里报告虚拟化平台无法启用。关掉安全软件的“虚拟化保护”功能后立刻就好了。这类问题很难排查因为提示信息往往不清楚如果你确认 BIOS 虚拟化已开启但 WSL 还是不行优先怀疑安全软件。坑三中文用户名导致挂载失败如果你的 Windows 用户名是中文比如C:\Users\张三Docker Desktop 在挂载某些目录时会出现编码问题。这个没有绝对通用的解决方法但有两个临时规避手段一是把工作目录放在纯英文路径下比如D:\Tools\OpenClaw二是用 WSL 内部的文件系统存放 OpenClaw 数据路径像/home/你的用户名/openclaw-dataWindows 侧的路径只在必要时挂载。5.3 升级与卸载要留个心眼OpenClaw 迭代快升级前先备份数据目录。如果你是用 docker compose 拉取的仓库升级流程是进入仓库目录执行git pull拉最新代码然后docker compose down再docker compose build和docker compose up -d。如果你用的是官方镜像直接docker pull 最新tag然后 recreate 容器即可。卸载 OpenClaw 有几个步骤容易漏停止并删除容器docker compose down如果用了 docker run则docker stop openclaw docker rm openclaw。删除镜像docker rmi openclaw镜像名节省磁盘空间。删除数据目录确认数据不需要了再删OpenClaw 的所有配置、日志、技能数据都在这个目录里删除不可恢复。可选清理 WSL 发行版如果你确定不再用 WSL可以在 PowerShell 执行wsl --unregister Ubuntu这会删除整个 WSL 文件系统操作不可逆先想清楚。Docker Desktop 卸载就走 Windows 设置里的应用卸载卸载后有余留文件可以用官网提供的清理脚本或手动删除%APPDATA%\Docker之类的残留目录。5.4 在 Windows 上扩展 OpenClaw 的经验顺序装完能跑只是开始。如果你想让 OpenClaw 真正干活建议按这个顺序往里加东西先加技能skills。打开技能市场或按官方文档安装示例技能比如搜索、文档处理、任务规划类。注意每个技能可能依赖额外的 Python 包或命令行工具技能装完要在 OpenClaw 的环境里确认依赖可用否则运行时会报“工具不存在”。再加外设能力。热搜里提到的“cau computer”应该是指 computer use 类功能也就是让智能体操作电脑。在 Windows 上做这件事要谨慎OpenClaw 容器默认跑在 Linux 环境里它要通过 WSL 才能操作 Windows 桌面这里面涉及权限、显式授权、界面识别准确性等一系列话题。建议先在一台不重要的电脑或虚拟机上验证不要直接在生产或主力机上放开。最后再碰多智能体编排。OpenClaw 的核心卖点就是多智能体协作但多智能体意味着更多的参数、更多需要调教的 prompt、更多的错误排查复杂度。先让单个智能体把一条任务链路跑顺再复制出第二个、第三个让他们协作。6. 写在最后我的实际使用体会OpenClaw 在 Windows 上安装这件事说难不难说简单也不简单。难的地方在于它把 WSL2、Docker、Git、模型服务四件事串在一起任何一个环节出了岔子表面症状都可能差不多——容器起不来、日志报错、界面空白排查起来需要一点耐心。简单的地方在于只要按顺序走每一步的目标都很明确你不是在“撞运气”而是在验证一个链条上的每一环。我个人在实际使用中的体会是Windows 上最容易出错的时间点恰恰不是 OpenClaw 本身而是它的前置依赖安装。WSL2 的内核更新、Docker Desktop 的 WSL Integration 勾选、镜像加速配置这三件事你只要按本文顺序走一遍后面几乎不会再遇到安装层面的坑。反过来如果你跳过这些直接去跑安装脚本出了问题反而会绕一大圈。最后再分享一个没用但在关键时刻能救命的小技巧OpenClaw 容器日志是可以持久化的。docker-compose 里配置 logging 参数把日志输出到文件或者用docker logs 日志文件.log重定向。当你的智能体任务跑了很久之后突然失败翻日志能定位到哪一步出了问题比盯着界面看转圈有用得多。按这套流程装下来的 OpenClaw后续扩展技能、接不同的模型服务、做多智能体编排都有了一个稳固的底座。剩下的事情就是在实际任务里慢慢调教了。