我把OpenClaw在Windows上的部署过程完整跑了一遍踩了不少坑也把OneClaw一键安装脚本里做的好多“隐形工作”扒了个底朝天。如果你正准备在Windows上搭一个属于自己的AI智能体助手又不想手动折腾WSL、Node、Docker这些底层环境那这篇文章就是为你准备的。我会把从零到能跑通、连上本地大模型的每一步都拆开讲清楚包括那些脚本帮你干了什么、为什么这么干以及出了问题该去哪排查。先说结论OpenClaw完全可以跑在Windows上而且不需要你懂Linux。它本质上是一个开源的“个人AI助手框架”你给它接上大模型本地的或者云端的它就能帮你操作文件、管理日程、收发邮件、跑脚本、调API甚至通过Windows Companion直接和你的桌面系统交互。最近大家看到很多类似WorkBuddy、Manus这类AI代理产品其实底层思路都和OpenClaw这类框架脱不开干系只是OpenClaw是开源本地部署的数据都在你自己手里可以玩得更野。适合谁看想用Windows当主力机部署AI代理的、想本地跑大模型又不想付费买云API的、以及对“AI替我操作电脑”这件事充满好奇的折腾党这篇都够用。我已经把所有需要手动配置的环节都换成了“照抄就能用”的命令和步骤。1. OpenClaw到底是个什么东西它解决了什么问题1.1 从“聊天机器人”到“能动手干活的智能体”如果你用过ChatGPT或者DeepSeek的网页版你看到的其实是一个“对话引擎”你问它答说得天花乱坠但它没法真正帮你把邮件发出去、把文件重命名、把Excel里的数据整理归档。OpenClaw这类框架解决的就是这个断层——它把大模型接到一个可以调用工具、读写文件、访问网络、触发系统命令的“躯干”上。打个比方大模型是大脑OpenClaw是神经系统加四肢。大脑负责想“该怎么做”OpenClaw负责把手伸出去执行。它可以拆解你的一句模糊指令比如“把下载文件夹里所有PDF按大小排个序然后把最大的那个邮件发给李雷”然后自己规划步骤、调用工具、一步步完成。这正是最近热搜里那些“AI代理产品”的共同思路。OpenClaw牛逼的地方在于它是开源的你可以完全本地部署不掏API钱不把隐私数据传出去。1.2 核心能力与应用场景按我的实测体验OpenClaw的看家本领有三个工具调用Skill/工具扩展官方和社区维护了大量“技能包”比如浏览器自动化、Gmail收发、日历管理、Git操作、HTTP请求、终端命令执行。这些不是摆设是真的可以跑通的。多模型兼容不只吃OpenAI的API本地用Ollama跑的Qwen、DeepSeek等开源模型也能直接接上另外还能对接各类兼容OpenAI接口的服务。Windows Companion这是Windows部署最吸引人的部分。装好之后AI能读取Windows通知、剪贴板、文件系统还能通过计划任务执行命令等于给你这台Windows电脑装了一个“AI遥控器”。1.3 为什么要在本地部署而不是直接用云服务这个问题我被问得最多。直接用云端AI服务它不香吗答案分两种人第一隐私敏感。你要让AI处理的可能是工作文档、本地代码、个人资料这些内容过一遍对方服务器心里总不踏实。本地部署之后数据不出你这台机器。第二长期成本。云端API看着便宜可你真让AI每天跑一堆自动化任务token消耗哗哗的。本地部署只要有一张说得过去的显卡或者哪怕只有CPU用Qwen2.5-3B这种小模型很多日常任务完全够用一次配置长期免费。当然本地部署也有门槛这正是Windows环境格外需要一篇保姆级教程的原因。2. Windows部署OpenClaw的思路OneClaw一键安装到底做了什么2.1 为什么OpenClaw在Windows上部署不省心OpenClaw底层是个Node.js服务官方文档默认面向macOS和Linux。Windows的问题在于很多依赖包、Rust工具链、Python原生模块在Windows下编译容易出幺蛾子另外Docker容器、WSL子系统这些概念对小白不友好。我自己第一次折腾的时候光是装依赖就遇到了“node-gyp编译失败”“找不到Python环境”“权限不足”三个拦路虎每一条单独看都不难但凑在一起能让人心态崩掉。2.2 OneClaw的定位把“脏活累活”打包进脚本OneClaw是社区里一位老哥弄的一键安装方案专门解决Windows用户的痛点。它做的事如果纯手动大概是这样一长串自动检测Windows版本检查并启用WSL2。检测Node.js环境没有就装版本不对就帮你切换。检测Docker Desktop可选确保以WSL2后端运行。把OpenClaw仓库克隆到固定目录安装npm依赖。生成一份基础.env配置文件把端口、密钥这类参数预设好。启动OpenClaw服务并提示你访问本地Web界面。你只需要做一件事以非管理员身份打开PowerShell敲一行命令然后按提示等它跑完。2.3 为什么推荐这种“被安排好”的方式很多人觉得一键脚本是“黑箱”不放心。我的看法是你可以把它当成一个“自动化操作员”脚本每一行都在终端里打印出来了你有兴趣就逐行看没兴趣就跑完再用。省下的时间用来理解OpenClaw怎么配置、怎么扩展技能那才是真正值钱的部分。另一个关键点是脚本强制你使用WSL2后端。你可能会问“我不用Docker行不行”行OpenClaw也能原生跑在Windows Node环境里。但用了Docker隔离性和可迁移性好很多以后换电脑或者想上服务器一套容器直接带走。OneClaw默认走WSL2 Docker其实是给你选了一条更稳的路。3. 环境准备三位主角缺一不可动手之前先检查你的Windows版本。推荐Windows 10 22H2以上或Windows 11这样WSL2的内核更新和虚拟化支持都最省心。3.1 第一步启用WSL2在Windows搜索框输入“PowerShell”右键选择“以管理员身份运行”然后依次执行wsl --install这个命令会启用“适用于Linux的Windows子系统”和“虚拟机平台”并自动安装默认发行版一般是Ubuntu。装完按提示重启电脑。注意如果你之前装过WSL命令会提示已有旧版本这时先跑wsl --update更新内核再跑wsl --set-default-version 2确保默认走WSL2。重启后在PowerShell里输入wsl --status如果看到“默认版本: 2”之类的信息WSL2就绪了。很多人在热搜词里反馈的“openclaw无法安全验证sl2环境请在powershell中运行 wsl --status”就是这一步没做扎实。3.2 第二步安装Node.js和GitNode.js是OpenClaw的运行底座建议用LTS版本18或20。去官网下载Windows安装包一路Next即可。装完在PowerShell里验证node -v npm -vGit用于拉取仓库同样去官网下载Windows版安装时建议保持默认选项其中“调整你的PATH环境”一定要选“从命令行使用Git”。3.3 第三步Docker Desktop跑容器版必装如果选择OneClaw默认的Docker部署方式Docker Desktop是必须的。下载安装包安装时确保勾选“使用WSL 2而不是Hyper-V”。安装完以后有一个巨大的坑必须提前说Docker Desktop不能用管理员权限启动。如果你用“以管理员身份运行”打开它十有八九会报这个错error: start the windows daemon from a non-elevated terminal; shared clients解决办法很简单从开始菜单正常双击启动或者用普通权限的终端执行。它的后端服务会自动在WSL2里拉起Linux Docker守护进程不需要你提权。启动Docker Desktop后在设置里找到“Resources → WSL Integration”确保你的发行版比如Ubuntu开关是打开的。4. OneClaw一键安装实操从脚本到第一个对话4.1 下载并执行OneClaw脚本找一个干净的目录比如D:\openclaw-setup打开普通权限的PowerShell粘贴irm https://raw.githubusercontent.com/OpenClaw/oneclaw/main/install.ps1 | iex这一步会下载并执行OneClaw脚本。如果你看到“无法加载脚本因为在此系统上禁止运行脚本”的报错是PowerShell执行策略在拦你切换到管理员窗口执行一次Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser然后重新运行上面的命令。脚本执行过程中它会自动拉取OpenClaw主仓库一般放在C:\Users\你的用户名\openclaw目录。整个过程需要几分钟取决于网络和机器性能。4.2 初始化配置API密钥与端口脚本跑完会提示你编辑.env文件。这个文件是OpenClaw的“总控台”里面需要填的核心配置如下OPENCLAW_API_KEYyour-secret-key WEBUI_PORT3030OPENCLAW_API_KEY是给外部调用用的密钥自己用的话随便填一串随机字符WEBUI_PORT是Web管理界面的端口默认3030如果你之前装过东西占用了这个端口改成3031之类即可。如果你暂不打算连外部API也想跳过云端模型先别急着关这个文件后面关联本地Ollama模型还要往这里加内容。4.3 启动服务并验证配置好以后在PowerShell运行cd ~/openclaw docker compose up -d提示首次执行会拉取镜像耗时会比较久耐心等待。之后每次启动就快多了。服务起来后打开浏览器访问http://localhost:3030看到OpenClaw的Web界面就说明服务端OK了。第一次进入会让你填入刚才设置的API密钥之后就能看到默认的聊天/任务输入框。5. 进阶配置Windows Companion与本地大模型强强联手5.1 Windows Companion是什么怎么配置Windows Companion是OpenClaw在Windows上的“外挂模块”它能让AI直接和你的系统打交道。具体能干什么实测下来包括读取Windows系统通知把新邮件、日历提醒等内容暴露给AI。共享剪贴板你可以把网页上复制的文本直接丢给AI处理。执行PowerShell命令或计划任务实现“AI替我打开某软件”“AI帮我定时清理临时文件”这类操作。读取本地文件目录让AI整理文件、批量重命名成为可能。OneClaw脚本通常会把Windows Companion的启动器放在C:\Users\你的用户名\openclaw\companion\目录。如果是手动配置注册文件大致思路是cd ~/openclaw/companion npm install node index.js跑起来以后窗口会显示“Companion connected”。此刻回到OpenClaw的Web界面你可以在对话里要求它“读取剪贴板内容并整理成Markdown表格”或者“把桌面截图保存到指定文件夹”它会调用Companion去执行。有个易踩的坑Windows Companion和OpenClaw主服务必须保持在同一台机器、且网络可互通如果两者之间隔了防火墙记得在Windows Defender里放行对应端口默认也是3030相关的回环端口。本地部署通常在同一台机器所以问题不大。5.2 关联本地大模型一次配置永久免费既然叫“本地部署大语言模型”那OpenClaw最好能接Ollama里的模型这样整套链路不依赖任何云端。你要做的就是两步。第一步先装Ollama并拉一个模型。在PowerShell执行ollama pull qwen2.5:3b这个模型体积只有2GB左右中英文能力在轻量模型里算能打的普通CPU也能跑是本地部署的入门首选。如果你显卡够强也可以换qwen2.5:7b或者更大的版本。第二步在OpenClaw的.env文件里加上Ollama的OpenAI兼容接口配置OPENAI_BASE_URLhttp://127.0.0.1:11434/v1 OPENAI_API_KEYollama PRIMARY_MODELqwen2.5:3b然后重启容器docker compose down docker compose up -d回到Web界面新建对话这时模型已经变成本地Qwen了。你可以直接要求它写一份周报、做一段数据分析脚本它全都能在本地处理。5.3 把DeepSeek等模型也接进来OpenClaw的好处是模型层解耦得很干净。只要Ollama支持你甚至可以同时配多个模型。想接DeepSeek的本地蒸馏版一样的套路ollama pull deepseek-r1:7b然后在.env里切换PRIMARY_MODELdeepseek-r1:7b重启即可。实测下来DeepSeek在逻辑推理类任务上比Qwen同规模要强一些但生成速度略慢日常高频小任务还是Qwen顺手。你完全可以一套框架、多个模型按需切换。6. 常见问题与排查技巧实录6.1 问题速查表症状常见原因解决办法脚本提示“禁止运行脚本”PowerShell执行策略限制运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUserwsl --status报错或提示内核无效WSL内核/虚拟机平台未正确启用以管理员身份运行wsl --update重启电脑Docker Desktop报“start the windows daemon from a non-elevated terminal”用管理员权限启动了Docker改用普通权限双击启动服务起来但网页打不开端口被占用或防火墙拦截执行 netstat -ano连接Ollama报错“connection refused”Ollama没启动或端口不对先运行ollama serve确保http://127.0.0.1:11434可访问OneClaw脚本跑到一半闪退网络不稳或目录权限不足重新以普通权限运行确认安装在C盘用户目录下6.2 几个值得展开的排查细节端口占用是Windows部署的第一大隐患。很多朋友之前装过别的服务3030这种端口早就被占了。排查命令必须是管理员命令行下执行netstat -ano | findstr :3030看到输出里有ESTABLISHED或LISTENING状态后面那串数字就是占用进程的PID。接着tasklist | findstr PID确认是哪个程序如果是无关程序要么改OpenClaw端口要么把这个进程停掉。改端口最省事改完重启服务即可。WSL2相关的“无法安全验证”报错本质上是因为Windows的虚拟机监控程序没有正常工作。除了wsl --update还要去“控制面板 → 程序 → 启用或关闭Windows功能”确认“虚拟机平台”和“适用于Linux的Windows子系统”两项都打勾了。如果之前装过旧版WSL先彻底卸载再重装能省很多事。PowerShell脚本窗口一闪而过脚本没法回显错误信息通常是执行策略拦截后脚本退出。不要直接双击运行ps1文件务必在PowerShell里用irm ... | iex管道方式执行这样错误信息会留在窗口里。Docker镜像拉取慢或失败国内网络环境下这基本是必遇问题。OneClaw脚本里其实已经做了镜像源切换但如果还是慢手动改Docker Daemon的registry-mirrors配置即可。这一步操作不难打开Docker Desktop设置里的Docker Engine填入镜像加速地址保存重启。7. 一点个人体会整个流程跑通之后我的感受是OpenClaw在Windows上部署真正的难点不在“装软件”而在“理解每一层依赖的关系”。WSL2给Docker提供Linux内核Docker给OpenClaw提供隔离运行环境OpenClaw通过Companion和本地模型完成对Windows和AI的串联。你把这个链路理清了以后不管遇到什么报错都能顺着链路一层层往下查。最后分享一个实用小技巧在OpenClaw的Web界面里你可以保存多条“预设指令”比如“把剪贴板内容转换成待办清单”“每天上午9点检查收件箱并整理优先级”。配好Windows Companion后这些指令相当于你给AI定的“部门SOP”它会按你的规则自动执行。时间一长你甚至会觉得这台Windows电脑有个隐形助手在帮你干活。这整套配置我建议大家都去试一次尤其是手里正好有闲置Windows电脑的装完你会重新认识“本地部署大语言模型”这件事。就冲着隐私在自己手里、长期不花钱这两点也值得折腾一晚上了。