1. 写在前面为什么我建议你在Windows上折腾OpenClawOpenClaw这个项目最近在AI自动化和个人助理圈子里热度一直没降过。简单说它是一个开源的个人AI助理框架能够把大模型接到微信、飞书、Telegram、Discord这些聊天渠道里还能让AI调用浏览器、执行命令、操作文件干一些真正“动手”的活儿。比起那种只能聊天的机器人OpenClaw更强调Agent的能力——你告诉它目标它自己拆解任务、调工具、再反馈结果。我之前在Linux服务器上跑过一段时间的OpenClaw稳定性和自由度都很满意。但问题来了很多朋友不是每个人都有云服务器大部分人的主力机器就是一台Windows电脑。大家就想在本地Windows上装一个OpenClaw拿来做日常自动化、接微信小号、跑一些定时任务。这需求完全合理但Windows下的安装和卸载比Linux要麻烦一些坑也多一些。这篇东西把我最近在Windows上装OpenClaw、跑通微信渠道、再把它卸干净的整个过程全部摊开来讲。包括环境怎么准备、一键脚本到底帮你干了什么、装完之后怎么配千问或者其他模型、怎么接微信、遇到“session file locked”“could not safely verify the WSL2 environment”这类报错怎么定位、最后怎么彻底卸载不留垃圾。全程基于我自己实际操作过的流程每个步骤都是可以照着做的。1.1 先搞清楚OpenClaw到底依赖哪些东西在Windows上装OpenClaw本质上不是在Windows系统里直接跑而是借助WSL2Windows Subsystem for Linux开一个Linux环境。OpenClaw本身需要Node.js运行时、Linux的进程管理、网络端口监听这些在纯Windows环境下运行会有各种兼容问题官方也不推荐。WSL2相当于在Windows里嵌了一个轻量虚拟机跑起来几乎无感文件系统互通命令行直接能用bash——这是Windows用户跑OpenClaw最平滑的路径。所以整个安装链条就是Windows系统 - 启用WSL2 - 安装Ubuntu发行版 - 在Ubuntu里装OpenClaw - 配置模型API和渠道 - 启动服务。你可能会问那热搜里提到的“openclaw windowshub安装”是什么情况WindowHub是Windows上的一个应用分发/管理组件OpenClaw的Windows安装脚本会通过它来补一些运行库和依赖但核心运行环境还是WSL2那一套。1.2 谁适合看这篇谁可以划走如果你只是听说过OpenClaw想试试看手里有一台Windows 10或Windows 11的电脑愿意折腾二十分钟到半小时那这篇就是给你准备的。如果你已经跑通过OpenClaw只是想找一个卸载干净的方法也可以直接跳到第四节看完整的卸载流程。但如果你完全不知道OpenClaw能干嘛也没想好要用它接哪个渠道、跑什么任务那我建议你先想清楚用途再动手因为装完之后如果你不配置模型API它只是一个空壳。下面所有内容我都假设你用的是Windows 10 22H2以上或者Windows 11建议内存不低于8G磁盘剩余空间不少于10G。WSL2会占几个GNode模块和OpenClaw本体再加渠道依赖空间太紧容易出幺蛾子。2. Windows环境准备WSL2与前置依赖一次搞定2.1 启用WSL2不只是装个Ubuntu那么简单很多教程会让你直接去Microsoft Store搜Ubuntu装一个但这其实有一个大前提Windows的“适用于Linux的Windows子系统”功能必须已经打开而且WSL版本要设置为2。否则你装完Ubuntu打开很可能卡在创建用户那一步或者启动的时候直接报“WSL2 environment”相关错误——热搜里那个“openclaw could not safely verify the WSL2 environment”就是这么来的。正确顺序是按Win X选择“终端(管理员)”或“Windows PowerShell(管理员)”。运行这条命令启用WSL功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart接着启用在Windows中嵌入虚拟机的平台功能dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart重启电脑。重启后打开PowerShell把WSL默认版本设置为2wsl --set-default-version 2再运行wsl --install -d Ubuntu-22.04让系统自动下载并安装Ubuntu发行版。这里有个细节wsl --install这条命令在较新的Windows版本里可以直接安装默认发行版但如果你之前装过WSL1或者其他发行版建议先运行wsl --list --verbose查看当前状态。像我自己就是装过WSL1的旧机器折腾了大半天才发现是版本不匹配。务必确认STATE显示的是Running 2。2.2 在Ubuntu里把基础依赖铺好Ubuntu装好后第一次启动会让你设置UNIX用户名和密码。注意这个用户名不一定非要和Windows用户名一致但密码一定要记牢因为后面所有sudo操作和WSL内服务管理都要用到。进入Ubuntu终端在Windows终端里输入wsl就能进去先做常规更新sudo apt update sudo apt upgrade -y然后安装基础工具链。OpenClaw在WSL里跑的时候经常需要curl下载资源、git拉取代码、vim或者nano改配置文件这些一次性装齐比较省事sudo apt install -y curl git vim build-essential接下来装Node.js。OpenClaw对Node版本有要求实测用Node 18或20都正常建议直接装20 LTS。用NodeSource源安装最干净curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs装完验证一下版本node -v npm -v如果你之前已经在Windows里装过Node.js那也没关系WSL2里的Ubuntu是一个独立环境和Windows的程序互不干扰。OpenClaw在WSL里跑用的就是Ubuntu内部的Node这点在排查问题时特别重要——很多新手在Windows命令行里看到node -v有版本就以为环境OK了结果进WSL发现根本没有这就是环境没对齐。2.3 为什么我建议不要直接用Windows版Docker来跑OpenClaw官方其实也提供Docker镜像的安装方式。很多朋友看到Docker就兴奋觉得自己Windows上装个Docker Desktop跑容器多干净。这个思路在Linux服务器上确实好使但在Windows上Docker Desktop本身就是跑在WSL2里的——等于你再用Docker在WSL里套一层容器层层嵌套网络模式和文件挂载都非常容易出问题。我试过在Windows Docker Desktop里跑OpenClaw容器经常遇到端口映射失效、微信登录时文件权限错乱的情况排查起来头大。所以我的建议是新手第一次装OpenClaw直接走WSL2 本机跑Node进程这条路等Passenger之后细讲跑起来以后再用服务管理的方式去维护进程。Docker方案留给已经熟悉容器概念的朋友二次研究。3. OpenClaw安装全流程从一键脚本到自定义配置3.1 一键安装脚本到底做了什么OpenClaw官方文档里给了一条很吸引人的命令号称一键安装。我实际跑通之后帮你拆一下这条脚本背后做了哪些事你别真的以为它只是“点一下就行”。在WSL2的Ubuntu终端里执行curl -fsSL https://openclaw.ai/install.sh | bash脚本执行过程中会依次完成以下动作检查环境—— 确认你是在Linux环境WSL2的bash环境会被识别为LinuxNode版本是否满足要求npm是否可用。下载OpenClaw核心包—— 从npm源或者GitHub Release拉取OpenClaw本体包存放到用户目录的.openclaw目录下。安装Passenger——openclaw/passenger是OpenClaw的依赖进程它负责代理大模型API请求、管理会话状态、处理多渠道消息路由。你可以把它理解成OpenClaw的“接电话总机”所有进出的消息都要经过它。安装CLI工具—— 全局注册openclaw命令让你能在终端里直接操作。初始化配置目录—— 在~/.openclaw/下生成openclaw.json配置文件和默认目录结构。脚本跑完后在WSL里敲openclaw --version能看到版本号就说明核心装好了。但这时候它还干不了活因为没有模型API配置也没有渠道接入。3.2 配置大模型API以千问为例OpenClaw本身不内置模型它需要你去对接一个大模型的API。热搜里那个“openclaw 配置千问”指的就是这个环节。千问通义千问的API在国内调用方便注册就有免费额度对新手比较友好所以我这里拿千问举例。进入配置目录cd ~/.openclaw然后用vim编辑openclaw.jsonvim openclaw.json打开后你会看到类似这样的默认结构。需要手动添加模型供应商配置。以阿里云百炼平台的千问API为例对应的配置大致是{ models: { providers: { qwen: { baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1, apiKey: 你的千问APIKey, models: [ { name: qwen-plus, contextWindow: 131072, maxOutputTokens: 8192 } ] } }, defaultProvider: qwen, defaultModel: qwen-plus } }APIKey需要你到阿里云百炼控制台去申请创建API-KEY之后复制粘贴进来。这里的baseUrl用的是DashScope兼容OpenAI格式的地址OpenClaw走的是OpenAI兼容协议所以可以这样直接对接。填好之后保存退出vim里按Esc输入:wq回车。然后重启OpenClaw服务让配置生效openclaw restart这时候可以做一个快速验证——在WSL里用CLI直接发一条消息给OpenClaw看它能不能正常调用千问回复openclaw chat 你好简单介绍一下自己如果返回正常说明模型链路已经通了。如果报错提示api error: the model has reached its context window limit那就是你选的模型上下文长度太小或者你在配置里给的contextWindow参数和实际模型不一致换成qwen-plus这类长上下文模型就能解决。3.3 接入微信渠道踩坑最集中的地方模型通了以后OpenClaw还是一台没有“手脚”的孤岛消息渠道才是它连接世界的桥梁。国内用户最常用的渠道就是微信个人号。OpenClaw对微信的支持是通过接管微信的Web/本地接口来实现的。配置通道的入口在openclaw.json的channels部分。最简单的配置方式是先启动OpenClaw然后用内置命令添加渠道openclaw channel add wechat执行这条命令后控制台大概率会提示你需要进行微信扫码登录。OpenClaw会起一个本地登录服务弹出一个二维码你用微信扫码确认登录它会尝试接管这个微信账号的消息收发能力。这里必须说清楚几个大坑。第一微信扫码登录不是你拿主号去扫。OpenClaw接管微信账号之后这个账号的所有消息都会被它拦截处理你再用手机微信登录同一个号会直接把另一端的登录挤掉。所以务必用一个小号、副号去对接不要拿工作号或者生活大号去试否则好友给你发消息却半天不回人设就崩了。第二登录态不是永久有效的。微信的登录凭证有时效过几天可能失效。如果发现OpenClaw突然不回微信消息了去WSL里查看OpenClaw日志大概率会看到登录过期或者token失效的提示。这时候需要重新执行openclaw channel add wechat再扫一次码。第三消息回复有被截断的风险。热搜里有条“openclaw在飞书输出容易被截断”飞书是这样微信其实也有类似问题。OpenClaw生成的回答如果太长发送时会被微信侧截断。解决办法是在配置里给回执消息加上分段规则channels: { wechat: { enabled: true, maxMessageLength: 1800, splitLongMessages: true } }我实测maxMessageLength设置在1500到2000字符之间比较安全超过这个长度会自动拆成多条发送每条之间加一个分割提示。这样既能保证内容完整又不会因为一条消息过长触发微信风控或者截断。3.4 验证OpenClaw是否活着的几个方法配置完成并重启之后别急着疯聊先做几项基本验证看进程状态—— 在WSL里执行openclaw status确认passenger和主进程都是running状态。看日志输出——openclaw logs --tail 50实时查看日志如果出现类似channel wechat started或者listening on port 8080之类的信息说明渠道接入成功了。发消息测试—— 用另一个微信账号给被接管的账号发一句“在吗”几秒内应该收到OpenClaw的回复。浏览器控制测试—— OpenClaw还内置了浏览器控制能力你可以在聊天里让它“打开摄像头并截图保存到本地”如果它能执行并返回文件路径说明Agent的完整链路已经通透了。注意如果在这一步发现OpenClaw能发消息给微信但微信发消息没回复这就有点棘手了。我在排查这类问题时发现往往是消息总线的回调地址没有正确配置——OpenClaw需要能收到微信侧推送的消息事件才能触发AI回复。看看日志里有没有msg received这种关键信息如果没有十有八九是消息接收链路没通。4. 常见安装与运行问题排查实录4.1 “could not safely verify the WSL2 environment”的原因与对策这个报错是Windows下安装OpenClaw时非常典型的。它出现的时机一般是安装脚本执行到环境检测阶段脚本会校验当前运行环境是不是真正的WSL2而不仅仅是WSL1或者其他虚拟环境。我做过的排查路径是这样的在PowerShell里执行wsl --list --verbose查看Ubuntu的版本列确认VERSION那一栏是2而不是1。如果显示版本是1执行wsl --set-version Ubuntu-22.04 2升级到WSL2。注意这个过程可能要几分钟且需要机器开启虚拟化。如果已经是2还是报这个错检查Windows功能里“虚拟机平台”是不是开着。这个功能和WSL2是绑定的关掉会直接导致WSL2无法正常运行。最后检查一下是不是在WSL里跑的bash。有那种在Windows命令行直接执行bash进入的Git Bash环境OpenClaw脚本识别不了也会报类似错误。务必从Windows Terminal里启动WSL而不是在CMD里敲bash。4.2 启动报错 “session file locked” 怎么办热搜里有一条很精准“agent failed before reply: session file locked (timeout 60000ms)”。我第一次在Windows上跑OpenClaw就遇到过这个问题具体表现就是消息发过去之后过了一分钟才报错内容大致是“agent failed before replysession file locked”。先说原因OpenClaw为每个对话会话维护一个session文件文件里存了上下文、状态和锁定标识。上一个请求处理完之后如果锁没有被正常释放下一个请求就会卡住直到超时。触发这个问题的常见场景有三个上一次请求异常中断—— Agent在处理消息时如果你强行停掉OpenClaw进程或者WSL重启锁文件来不及清理。同一会话并发请求—— 你同时用两个终端或者两个渠道给同一个session发消息OpenClaw不允许同一session并行写入第二个请求就会等锁。文件系统权限问题—— WSL和Windows文件系统之间的权限继承偶尔抽风导致OpenClaw进程无法删除或更新session文件。解决办法分几步走。先尝试彻底重启OpenClaw服务openclaw stop openclaw start如果重启后还是不行那就是锁文件本身残留了直接找到会话目录删掉lock文件ls ~/.openclaw/sessions/ rm -f ~/.openclaw/sessions/*.lock注意不会是你正在进行的那些会话的上下文全没了只是把锁定态清掉。删掉之后重新发消息就正常了。如果你遇到的是频繁地锁死建议检查一下是不是并发问题——给OpenClaw接多个渠道时消息进入同一个session就会打架。可以在配置里给不同渠道划分独立的sessionId前缀比如微信渠道的session用wechat_开头飞书渠道用feishu_开头避免互相锁。4.3 模型上下文超限与API超时“api error: the model has reached its context window limit” 这个我在第二节提到过一次这里展开说一说。大模型每次会话都有上下文长度限制也就是它能“记住”的token数是有限的。qwen-plus的上下文窗口有131072个token虽然很长但如果你让Agent连续处理大量文本或者让它循环调用工具、来回传数据很快就能把上下文填满。碰上这个问题的常规解法有三个方向换更大上下文窗口的模型—— 千问系列的qwen-max上下文更长或者直接选择支持超长上下文的模型。开启OpenClaw的上下文压缩—— 在模型配置里加上自动摘要和裁剪策略让Agent在长度接近上限时把早期对话摘要成一段短文本再继续。手动开新会话—— 把当前会话的内容清掉重新起一个topic。虽然粗暴但很多时候最有效。而“api error”类的超时问题多半是网络或者并发导致的。国内直连某些海外模型服务时延迟很高OpenClaw默认的请求超时时间是60秒如果模型侧需要更长的思考时间就得手动调大超时。在模型配置里加requestTimeoutMs: 120000实测对复杂任务的效果非常明显。5. OpenClaw彻底卸载Windows环境下的完整清理方案5.1 什么叫“彻底卸载”OpenClaw的卸载比一般的Windows软件卸载麻烦不少原因是它横跨了Windows和WSL2两个环境。如果你只是把Windows上装的那个安装包删了WSL2里的Ubuntu发行版、OpenClaw的Node模块、配置目录、session数据全都在一启动wsl进去OpenClaw还在。所以“彻底卸载”意味着你要做三件事停服务、删配置、清理WSL环境或者整个Ubuntu发行版。5.2 卸载前的最重要一步备份动手之前务必先备份你现有的配置和数据。因为在删除配置目录的那一刻你就再也找不回历史会话记录了。备份很简单把WSL里的.openclaw目录整个复制出来cp -r ~/.openclaw ~/openclaw-backup这一步绝对不要省。我见过不止一个朋友卸载OpenClaw之后后悔想把之前的会话、配置、渠道设置找回来结果干干净净什么都没有只能重新配一遍。备份文件放在WSL的home目录下之后即使你把Ubuntu删了也可以先用wsl --export备份整个发行版之后想恢复再wsl --import回去。5.3 三步式卸载流程卸载第一步停掉OpenClaw所有服务。进入WSL执行openclaw stop确认进程全部停止openclaw status这里要注意如果openclaw命令本身是通过npm全局安装的直接用npm卸载掉CLIsudo npm uninstall -g openclaw/cli第二步删除配置目录和所有数据rm -rf ~/.openclaw rm -rf ~/.openclaw-passenger配置目录删掉之后这个用户下就没有OpenClaw的任何运行痕迹了。第三步清理WSL环境。这里有两个选择。如果你以后还要用WSL做别的开发那就不删Ubuntu只是把OpenClaw相关的东西删干净就可以了。如果你打算连WSL环境一起移除在PowerShell里执行wsl --unregister Ubuntu-22.04这条命令会删掉整个Ubuntu发行版相当于格式化了一个虚拟机。执行前系统会提示确认输入y。注意这个操作是无情的——你在这个发行版里装的所有东西都会消失。5.4 核心要素速查表为了方便你对照操作我列了一张完整的卸载要素表清理对象位置操作方式OpenClaw数据目录WSL内~/.openclaw/rm -rf ~/.openclawPassenger依赖数据WSL内~/.openclaw-passenger/rm -rf ~/.openclaw-passenger全局CLI命令WSL内npm全局目录sudo npm uninstall -g openclaw/cliWSL发行版Windows侧PowerShell执行wsl --unregister Ubuntu-22.04WSL功能组件Windows侧可选PowerShell执行wsl --shutdown后通过控制面板关闭如果不删WSL只想验证OpenClaw清理是否彻底就在WSL里执行which openclaw ls ~/.openclaw如果两条命令都提示找不到或者目录为空那就说明干净了。6. 从安装到卸载我的几点实际感受最后说说我在这几轮安装、使用、卸载OpenClaw过程中积累的个人判断。OpenClaw在Windows上的体验说句实话现在已经比一年前成熟太多了。以前你要自己在WSL里从源码编译、手动装一堆依赖稍有闪失就得重来。现在有了一键安装脚本有相对完善的服务管理命令有清晰的配置格式普通用户照着文档走一遍是能跑通的。但它的定位终究不是一个“双击安装、打开即用”的Windows原生软件它骨子里还是Linux生态的东西Windows只是提供了一个托管环境。所以你心态上要做好“这是一个需要命令行操作的服务”的准备遇到问题会看日志、会查配置文件就成功了一大半。我用OpenClaw跑了大概一个月最舒服的用法是把它当作一个可以对话的自动化管家——日常让我它定时抓取网页信息、帮我管理RSS订阅、把关注的动态汇总发到微信。那些“让AI操作浏览器”的复杂任务比如自动填表、自动下单之类受限于页面结构和风控稳定性还不够理想适合折腾但不适合当作核心依赖。如果你决定卸载那就按照上面的步骤做完别留尾巴。如果你还打算继续用那就在第一次跑通之后好好研究一下它的配置文件把模型参数、渠道参数、权限边界都调到适合自己的状态——这个东西调好了是真的能变成一个很顺手的个人助理。每个人的需求不一样OpenClaw也不是什么人什么时候都需要。但如果你恰好需要一个能接微信、能调用模型、还带点自动化能力的Agent框架那它值得你在Windows上好好折腾一回。