乐于分享
好东西不私藏

OpenClaw安装并接入微信(WSL)

OpenClaw安装并接入微信(WSL)

OpenClaw 是什么?

OpenClaw 是 claw 的一个社区驱动的开源实现或分支(原项目 claw 由 Anthropic 的一位工程师用 Rust 开发)。它本质上是一个运行在你终端里的自主 AI 代理设计目标非常直接:让 AI 真正动手操控你的电脑,而不仅仅是回答问题。它能做的事包括:

• 
在终端里执行任意 shell 命令
• 
读写、创建、修改文件
• 
连续完成多步骤任务(如“从 GitHub 拉项目,修 bug,交 PR”)
• 
自动安装依赖、运行测试、部署服务
• 
 通过内置权限控制,在执行危险操作前请求你的批准

OpenClaw安装:使用预编译二进制

直接上Github上下载一个Release发布版下载到本地后,接下来就是正常的软件安装步骤

安装完后会提示是否安装一个WSL作为网关或进行高级安装,这里我选第一个这里在我电脑上直接进入一步安装会有问题,主要是WSL平台和镜像问题导致自动完成有问题而中断

第一个问题:WSL平台没安装

问题

运行上面的一键安装后,第一步执行就报错了,反正我电脑上是会这样的,根据提示:WSL平台安装失败日志如下为什么?因为我的Windows 系统尚未真正启用 WSL 功能组件,而自动安装失败,所以需要手动安装

解决

根据千问提示进行安装

开启BIOS虚拟化

首先检查BIOS虚拟化是否开启,正常电脑上都是有开启的可以在任务管理器中验证如果没有开启则进入BIOS中修改(开机时长按F2或Delete键,不要害怕进入BIOS,UI界面还是很好操作的加上AI技术这么先进,不懂可以问AI)

安装WSL

这一步需要等非常旧,耐心点,可以查看资源管理器中你的C盘大小如果一直有在明显变化就说明在工作,不是网络问题也没有卡死

安装完之后记得重启,没重启不知道可不可以,但既然AI说了那就重启吧

验证安装

重启后查看版本一般都是安装WSL2安装完后重新执行OpenClaw一步安装即可继续安装后大概会在第四步左右遇到问题再次失败

第二个问题:没安装或启用 Hyper-V / 虚拟机平台组件

问题

WSL2 本质上是一个轻量级虚拟机,它强依赖 Windows 的“虚拟机平台”功能。OpenClaw 在尝试创建 Ubuntu-24.04 的 WSL2 实例时,因为底层虚拟化引擎缺失而直接崩溃。

解决

这里关闭安装并手动开启Hyper-V这里在验证环境是否正常时发现WSL无启动注意这一步会下载Ubuntu并安装,但是我们这一步不是为了安装而是为了验证环境,实际上这里一般都会失败,大家可以不用试为什么一般都会失败,因为WSL的运行需要一个关键底层组件:Hyper-V 的核心服务这里有三个方案第一个:强制安装Hyper-V核心组件(推荐),我用到就是这种

#1234567dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart  dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart  # 2. 关键一步:强制安装 Hyper-V 核心(绕过家庭版限制)  # 下载并安装 Microsoft 提供的 "Windows Hypervisor Platform" 补丁包(官方支持)  # 或直接使用以下命令注入必要驱动(需联网):  bcdedit /set hypervisorlaunchtype auto

其他两种验证systeminfo | findstr /C:”Hyper-V” 查看Hyper-V相关的系统信息(powershell可能乱码)使用cmd(Get-Service vmcompute -ErrorAction SilentlyContinue) -ne $null查看HCS服务是否可用之后又可以开心地回到一键安装,跑到如下这一步就说明你的电脑可用WSL了

OpenClaw向导配置

安装完后提示是否进入向导,这里最好按照向导来,可以帮助你快速了解OpenClaw并配置基本项,如果有默认或建议则按默认即可,除非你有自定义需求提示:这是默认个人使用模式,而共享/多用户场景需要额外安全加固(lock-down)。是否继续,直接继续即可模型和API部分我使用的是DeepSeek,这里按照DeepSeek的文档进行配置即可当配置到渠道这里选择为微信,之后可在微信中接入配置完后即可进入如下界面之后可以继续在软件或浏览器进行配置修改软件侧提供了树形修改网页端修改,URL如图,端口默认为18789,需要确保软件侧路由开启才可访问网页端如果你觉得还是不方便,可以直接到WSL里进行配置文件修改或openclaw提供的配置命令修改

问题三:无法与DeepSeek建立连接

问题

这里问题是和OpenClaw对话后等了老半天还是不行,最后失败在WSL中使用curl测试到DeepSeek的API连通性成功,而且在openclaw启动的路由中也可看到连接成功一下后就导致 ECONNRESET断开

解决

解决方案一:windows侧搭反向代理处理MTU(不推荐,供学习与备选)

这里我卡了好久,最后使用Claude code接DeepSeek让其自行解决  

windows侧使用Node.js跑一个反向代理,并使用powershell启动并添加启动脚本到自启动目录中,注意在安全软件中添加信任否则当木马处理

这里WSL使用的是NAT模式,ip一般不变

如果会变,就在WSL侧写了个IP自动获取的脚本以确保可以每次可正确设置代理为windows上我们的代理

解决方案二:修改WSL侧的MTU(推荐)

这里我回看了千问分析为什么curl可以但api请求不可的回答,发现其就有关于WSL资源相关配置提示,至于为什么Claude code会出现第一种解决方案是因为其自己尝试修改MTU时出现其他问题导致误判MTU方案不可行

于是我又要求Claude code设计实验证明,结果发现还是出现会生成其他问题导致误判方案的问题,但是经过不断对话,其从上下文中以及新测试时发现原先方案失败是其他原因导致的所以只要调整WSL侧的MTU即可编辑wsl.conf需要root权限,powershll中可按如下root到WSL中,默认安装是没有设置root密码的,可以通过powershell上root登录并passwd设置密码,我设的是1234查看当前WSL中网卡的MTU值

plaintext1234wsl -d openclawgateway -u root  #windows下root登录wsl# 查看mtuwsl -d openclawgateway -u openclaw ip addr show eth0 | findstr mtuip addr show eth0 | grep mtu

问题成因(为什么MTU会导致失败)

首先需要知道为什么MTU会导致连接问题网络上的数据包有一个MTU限制,用于控制发出数据包的分片大小,对于大模型API请求这里输入输出多时就需要分片,而网络链路上只要有一个结点无法承载高的MTU则需PMTUD重新协商那么为什么没有协商呢,这是因为WSL在NAT下的网络中会吞噬这个协商数据包

解决后即可对话

接入微信渠道

这里我让OpenClaw辅助完成微信的接入