Windows WSL2 安装 OpenClaw 踩坑指南

Windows WSL2 安装 OpenClaw 踩坑指南在 Windows 上运行 OpenClaw AI 助手 WSL2 是最推荐的方案 相比纯 Windows 环境 WSL2 有这些优势 原生 Linux 环境 依赖兼容更好 支持 systemd 守护进程更稳定 内存管理更灵活 可配置 与 Windows 共存 切换无压力 适用场景 Windows 11 10 WSL2 Debian 以管理员身份打开

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



在 Windows 上运行 OpenClaw(AI 助手),WSL2 是最推荐的方案。相比纯 Windows 环境,WSL2 有这些优势:

  • ✅ 原生 Linux 环境,依赖兼容更好
  • ✅ 支持 systemd,守护进程更稳定
  • ✅ 内存管理更灵活(可配置)
  • ✅ 与 Windows 共存,切换无压力

💡 适用场景:Windows 11(10) + WSL2 (Debian)


以管理员身份打开 PowerShell,依次执行:

 
   

⚠️ 执行完必须重启电脑!


重启后,在 管理员 PowerShell 里执行:

 
    

 
     
 
     

🔧 如果不是,执行:

 
     
 
      
 
      

在 Windows 用户目录下创建 :

 
       

为什么要关闭自动内存回收?
Windows 默认会在内存紧张时回收 WSL 的内存,这会导致 OpenClaw 网关进程被杀、WebSocket 断连。



🔄 改完后重启 WSL:

 
       

OpenClaw 的网关需要 systemd 来做守护进程。

检查配置,编辑 :

 
        

🔄 重启 WSL 生效。验证:

 
        
 
         

⚠️ 重要提示:一键安装需要访问github,node等环境,安装失败大部分原因是国内网络问题


步骤 1:安装 nvm 并管理 Node.js 版本

 
          

步骤 2:配置 npm 全局路径(避免 sudo 权限问题)

 
          

步骤 3:手动安装 OpenClaw

 
          

如果上述两种方法都失败,个人建议直接上魔法吧,


步骤 1:初始化 OpenClaw 配置(交互式)

 
           

这会启动交互式配置向导,主要设置:

  • 模型提供商:填你的 API 地址和 key
  • 网关模式:选 local
  • 网关端口:默认 18789

准备自己的账号和API API 地址和 key,我用的是硅基流动, 使用的模型Id是 ,去创建一个密钥,后面需要用到 image

模型提供商配置

  • 选择 并回车;
  • 输入 API 地址:;
  • 选择 ,粘贴你在硅基流动生成的密钥; image

Skills 安装配置

  • 直接按 全选默认 Skills(推荐),或按空格键逐个选择;
  • 回车确认,等待 Skills 自动安装完成; image image 关键配置说明
  • 网关模式选 ,端口默认 (可手动修改);
  • 配置文件路径:。

⚡ 重点!,如果具备外网环境可不需要配置

🌐 WSL2 里的网络环境比较特殊 —— 它有自己的虚拟网卡,不能直接用 Windows 侧的 127.0.0.1 代理。

Win11(22H2)镜像(Mirrored)模式下 wsl 可不需要额外配置代理网络,此配置在WSL NAT(默认)需要额外代理端口转发

 
            

📍 假设你的 Windows 代理客户端监听 10808 端口(SOCKS5),那 WSL 里的代理地址通常是:

 
             

⚠️ 你的代理客户端需要开启 "允许局域网连接"

💡 Node.js 的 fetch 不认 SOCKS5 代理,需要用 Privoxy 做协议转换:

 
            

编辑 ,在末尾加一行:

 
            

启动 Privoxy:

 
            

📍 Privoxy 默认监听 (HTTP 代理)。

 
            
 
             
 
             

🔧 systemd user service 默认就是开机自启的。但 WSL 有个问题:Windows 重启后 WSL 不会自动启动

解决方案:创建 Windows 定时任务

  1. 在 目录下创建 :
 
             
  1. 打开 Windows 任务计划程序,创建任务:
    • 触发器:每 2 分钟重复
    • 操作:
    • 勾选 “不管用户是否登录都要运行”

 
              

⚠️ 如果需要经常执行 sudo 命令:

 
               

🔒 安全提示: 这个只在 WSL 里配,不要在生产服务器上这么干!


🌐 网关启动后,打开浏览器访问:,如果网关概览没有连接上,可以输入Token再进行连接 直接执行 得到带Token的链接,去浏览器进行访问链接就好

 
                

🔑 首次访问需要输入 gateway token(在 openclaw.json 的 gateway.auth.token 里)。


全部配完后,逐项检查:

 
                 

❓ 问题 ⚡ 原因 🔧 解决方案 网关莫名断连 Windows autoMemoryReclaim 回收内存 .wslconfig 里设 git clone 卡死 socks5h 让代理服务器解析 DNS 改用 Chromium 弹窗到 Windows 桌面 用了 WSLg 的 :0 显示器 Xvfb 用 :99 systemd service 不启动 需要 user session 用

 
                   

搞定了!其实核心就三件事:

  1. systemd —— 让网关能守护进程运行
  2. 代理链路 —— Privoxy 做 HTTP→SOCKS5 转换
  3. 保活 —— .wslconfig 关内存回收 + Windows 定时任务拉起 WSL

🎉 祝你在 WSL2 上玩得开心!如果有问题,欢迎在评论区交流~


小讯
上一篇 2026-03-30 07:37
下一篇 2026-03-30 07:35

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/231029.html