1. 首页首页
  2. 科技前沿科技前沿

Windows 下 OpenClaw 完整部署指南（原生 + WSL2 双版本）

科技前沿 • • 阅读 0

Windows 下 OpenClaw 完整部署指南（原生 + WSL2 双版本）OpenClaw 是 GitHub 史上增长最快的开源项目之一 Star 26 2w 不是普通聊天机器人 而是能直接操作电脑的 AI 数字管家 它打破了 AI 只会动嘴 的局限 能真正落地执行任务 自动整理下载文件夹 按类型 日期归档文件 读取论文 文档并生成结构化摘要 配置定时任务 自动推送每日资讯 消息 接入飞书 Telegram Discord 等多平台聊天工具

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



OpenClaw 是 GitHub 史上增长最快的开源项目之一（Star 26.2w+），不是普通聊天机器人，而是能直接操作电脑的 AI 数字管家。它打破了 “AI 只会动嘴” 的局限，能真正落地执行任务：

  • 自动整理下载文件夹、按类型 / 日期归档文件
  • 读取论文 / 文档并生成结构化摘要
  • 配置定时任务，自动推送每日资讯 / 消息
  • 接入飞书、Telegram、Discord 等多平台聊天工具

一句话总结：别的 AI 教你怎么做，OpenClaw 直接帮你做完，解放双手的本地 AI 工具。

搞懂这 4 个概念，能少走 90% 的弯路，避免安装时一脸懵。

表格

概念 通俗解释 核心作用 终端 / PowerShell Win+R 输入 打开的黑窗口 给电脑发送指令的 “指挥台”，所有安装命令都在这里执行 Node.js OpenClaw 的运行 “地基”，要求版本 ≥22 让电脑能读懂 OpenClaw 的代码，相当于 “翻译官”，自带 npm（应用商店） API Key 调用 AI 模型的 “身份凭证” 像健身房会员卡，让 OpenClaw 能连接 MiniMax 等模型的 “大脑”，无 Key 无法运行 WARN / ERROR 终端日志的两种状态 黄色 WARN = 小提醒，不用管；红色 ERROR = 真实报错，需优先处理

无论选择哪种部署方式，核心流程都一致，先记牢这 5 步：

  1. 安装运行环境（Node.js，WSL2 需额外配置 Linux 系统）
  2. 安装 OpenClaw 主程序
  3. 运行配置向导（选择模型、填写 API Key）
  4. 申请 MiniMax API Key（国内最稳方案）
  5. 启动网关，进入控制台验证使用

无需额外安装虚拟机，直接在 Windows 系统部署，步骤简单、上手快。

1. 安装 Node.js（核心依赖）

  1. 打开下载官网：https://nodejs.org/en/download
  2. 选择 Windows Installer (.msi) 64-bit 版本，确保版本号 ≥22（如 v22.14.0 LTS，LTS 为长期稳定版，优先选）
  3. 双击下载好的安装包，一路点击 Next，有 2 个关键注意点：
    • 许可协议页：勾选「I accept」，继续 Next
    • 自定义设置页：必须勾选 Add to PATH（系统能找到 node 命令，不然后面全白装）
  4. 安装完成后，验证是否成功： powershell
    • 按 ，输入 打开终端
    • 输入以下命令，分别显示版本号即为成功：
     
    5.  
      
 
      
2. 安装 OpenClaw 主程序
 
      
     
       
  1. 以管理员身份打开 PowerShell（关键！普通权限可能安装失败）： 
        
       
         
    • 左下角搜索「PowerShell」，右键点击选择「以管理员身份运行」
      •  
        
     
    2.  
       
  2. 执行一键安装命令： 
    powershell
     
    GPT plus 代充 只需 145
     
        
       
         
    • 解释： 是下载命令， 是执行下载的脚本，一行搞定安装
      •  
        
     
    3.  
       
  3. 若提示「禁止运行脚本」（红色报错），先执行以下命令解除限制： 
    powershell
     
     
        
       
         
    • 输入 确认，再重新执行上面的安装命令
      •  
        
     
    4.  
       
  4. 验证安装： 
    powershell
     
    GPT plus 代充 只需 145
     
        
       
         
    • 显示版本号，说明 OpenClaw 安装成功
      •  
        
     
    5.  
      
 
      
3. 运行通用配置向导（Mac/Windows 通用）
 
      
在管理员 PowerShell 中执行配置命令：
 
      
powershell
 
      
 
      
向导步骤逐行照填，不懂就选默认，默认值是开发团队推荐的最优配置：
 
      
     
       
  1. 工作区路径：直接回车，使用默认路径（存储 OpenClaw 配置、聊天记录等）
    2.  
       
  2. 选择 AI 模型提供商：方向键上下选择 MiniMax，回车（国内直连、性价比最高）
    3.  
       
  3. 输入 API Key：暂时跳过，后面会教你申请，粘贴后回车
    4.  
       
  4. 网关端口：默认 18789，直接回车（基本不会被占用）
    5.  
       
  5. 聊天平台接入：选「Skip 跳过」（先跑通主程序，避免多配置冲突）
    6.  
       
  6. 安装守护进程：输入 ，回车（让 OpenClaw 后台运行，开机自启，方便使用）
    7.  
       
  7. 确认配置摘要：查看无错误后，回车完成配置
    8.  
      
 
      
4. 申请 MiniMax API Key（国内最稳方案）
 
      
OpenClaw 本身免费，但需要 AI 模型 “大脑”，MiniMax 是国内用户的最优选择（直连、无需代理、Coding Plan 专门适配高频任务）。
 
      
     
       
  1. 打开 MiniMax 开发者平台：https://platform.minimaxi.com/
    2.  
       
  2. 手机号注册账号，完成实名认证（3 分钟内搞定，必须实名才能使用）
    3.  
       
  3. 登录后，左侧菜单进入 API Keys（或右上角头像 → 账号设置 → API Keys）
    4.  
       
  4. 点击「创建新的 API Key」，名称填 （方便识别），点击确认
    5.  
       
  5. 关键操作：复制生成的 Key（只显示一次！关闭页面后无法再查看），粘贴到备忘录 / 记事本妥善保存
    6.  
       
  6. 回到配置向导，右键粘贴 Key，回车（终端不显示 Key，属于正常安全机制）
    7.  
      
 
      
5. 首次运行 & 验证成功
 
      
     
       
  1. 启动 OpenClaw 网关服务： 
    powershell
     
    GPT plus 代充 只需 145
     
    2.  
       
  2. 看到终端显示 即为启动成功（不要关闭这个终端，关了服务就停了）
    3.  
       
  3. 打开浏览器，访问本地控制台： 
    plaintext
     
     
    4.  
       
  4. 在输入框发送指令： 
        
       
         
    • 收到 AI 正常回复 = 部署完全成功！
      •  
         
    • 若页面无法加载，检查是否开启防火墙权限（见下文排错）
      •  
        
     
    5.  
      
 
      
 
       
 
       
 
       
安装时遇到红色报错不用慌，这 4 个问题 90% 的新手都会遇到，直接照抄解决：
 
       
     
        
  1. 问题 1：脚本禁止运行 
         
       
          
    • 报错：无法加载文件，禁止运行脚本
      •  
          
    • 解决：执行解除策略命令后重装
      •  
         
     
    powershell
     
    GPT plus 代充 只需 145
     
    2.  
        
  2. 问题 2：‘openclaw-cn’ 不是内部或外部命令 
         
       
          
    • 原因：安装后环境变量未刷新
      •  
          
    • 解决：关闭当前 PowerShell，重新以管理员身份打开，再验证命令
      •  
         
     
    3.  
        
  3. 问题 3：端口 18789 被占用 
         
       
          
    • 报错：端口被占用，无法启动网关
      •  
          
    • 解决：查看占用进程并强制结束
      •  
         
     
    powershell
     
     
    4.  
        
  4. 问题 4：浏览器访问 127.0.0.1:18789 打不开 
         
       
          
    • 原因：Windows 防火墙拦截了 Node.js 网络通信
      •  
          
    • 解决：
      •  
         
    5.  
       
 
       
 
       
GPT plus 代充 只需 145 
       
    
         
     
          
  1. 打开「控制面板 → Windows Defender 防火墙 → 允许应用通过防火墙」
    2.  
          
  2. 点击「更改设置」，找到 Node.js，勾选「专用」和「公用」
    3.  
          
  3. 若找不到 Node.js，点击「允许其他应用」，手动添加路径：
    4.  
         
 
 
       
 
        
 
        
适合追求更稳定的 Linux 运行环境、避免 Windows 原生权限 / 兼容问题的用户（新手也可尝试，步骤更严谨）。
 
        
1. 启用 WSL2 并安装 Ubuntu
 
        
     
         
  1. 以管理员身份打开 PowerShell，执行启用命令： 
    powershell
     
     
    2.  
         
  2. 等待安装完成后，必须重启电脑（不重启无法生效）
    3.  
         
  3. 重启后自动进入 Ubuntu 初始化，设置用户名和密码（自定义即可，记住密码）
    4.  
        
 
        
2. 进入 WSL 并更新系统
 
        
     
         
  1. 后续进入 WSL，直接在 PowerShell 输入 即可
    2.  
         
  2. 更新系统包（确保软件最新，避免安装报错）： 
    bash
     
    运行
     
    GPT plus 代充 只需 145
     
          
       
           
    • 输入之前设置的 Ubuntu 密码，等待更新完成
      •  
          
     
    3.  
        
 
        
3. 安装 Node.js 22+（WSL 专用）
 
        
WSL 是 Linux 系统，安装命令与 Windows 不同：
 
        
bash
 
        
运行
 
        
 
        
     
         
  • 显示版本号（≥22）即为成功
    •  
        
 
        
4. 安装 OpenClaw 主程序
 
        
WSL 下使用 Linux 安装脚本，一键执行：
 
        
bash
 
        
运行
 
        
GPT plus 代充 只需 145
 
        
     
         
  • 验证安装：
    •  
        
 
        
bash
 
        
运行
 
        
 
        
     
         
  • 显示版本号，说明安装成功
    •  
        
 
        
5. 配置 & 启动（与 Windows 原生完全一致）
 
        
     
         
  1. 运行配置向导： 
    bash
     
    运行
     
    GPT plus 代充 只需 145
     
          
       
           
    • 步骤同原生部署：选 MiniMax → 填 API Key → 端口 18789 → 跳过聊天平台 → 安装守护进程（Y）
      •  
          
     
    2.  
         
  2. 启动网关： 
    bash
     
    运行
     
     
    3.  
         
  3. 访问控制台：在 Windows 浏览器 输入地址（WSL 与 Windows 共享网络）： 
    plaintext
     
    GPT plus 代充 只需 145
     
    4.  
         
  4. 发送指令验证，有回复即为成功。
    5.  
        
 
        
6. WSL2 专属常见问题
 
        
     
         
  1. 重启后找不到 WSL：PowerShell 输入 即可进入
    2.  
         
  2. Node.js 命令找不到：执行 重新安装
    3.  
         
  3. 网关启动后端口无法访问：确保 WSL 内网关正常运行，Windows 直接访问 即可
    4.  
        
 
        
 
         
 
         
 
         
部署成功后，直接体验 OpenClaw 的核心价值 ——动手帮你干活。新手必做这个任务，直观感受它和普通 AI 的区别。
 
         
任务目标
 
         
自动整理「下载文件夹」，按文件类型分类（图片、文档、压缩包、软件、视频等），告别杂乱下载内容。
 
         
1. 前提准备
 
         
确保 OpenClaw 网关正在运行（终端未关，显示 ）。
 
         
2. 打开控制台
 
         
浏览器访问：
 
         
3. 发送核心指令
 
         
直接复制粘贴以下句子发送给 OpenClaw：
 
         
plaintext
 
         
 
         
4. 查看执行结果
 
         
     
          
  1. OpenClaw 会自动执行以下步骤： 
           
       
            
    • 扫描你的 Windows 下载文件夹（路径：此电脑 → 下载）
      •  
            
    • 自动创建分类子文件夹
      •  
            
    • 移动对应类型文件到对应文件夹
      •  
           
     
    2.  
          
  2. 执行完成后，终端会显示进度日志，浏览器也会同步反馈结果
    3.  
          
  3. 打开「下载文件夹」查看，文件已整整齐齐分类完成！
    4.  
         
 
         
进阶实用指令（可直接复制使用）
 
         
     
          
  1. 按日期整理下载文件夹：
    2.  
         
 
         
plaintext
 
         
GPT plus 代充 只需 145
 
         
     
          
  1. 仅整理图片文件：
    2.  
         
 
         
plaintext
 
         
 
         
     
          
  1. 扫描重复文件（安全无删除）：
    2.  
         
 
         
plaintext
 
         
GPT plus 代充 只需 145
 
         
⚠️ 重要注意事项
 
         
     
          
  • OpenClaw 会真实操作电脑文件（移动、删除、修改），建议先备份重要文件，熟悉操作后再放开完全权限
    •  
          
  • 若不想让它操作某个磁盘，可在配置向导中限制访问路径
    •  
         
 
         
 
          
 
          
 
          
至此，你已经完成了从 0 到 1 的部署，拥有了一个完全免费、开源、本地运行、可自主操作的 AI 数字管家：
 
          
     
           
  1. 成功安装 Node.js 运行环境
    2.  
           
  2. 完成 OpenClaw 原生 / WSL2 双模式部署
    3.  
           
  3. 配置国内最稳的 MiniMax 模型大脑
    4.  
           
  4. 实现本地 AI 助手的正常运行
    5.  
           
  5. 完成第一个自动化文件整理任务
    6.  
          
 
          
后续可拓展：接入飞书、Telegram 等聊天平台，实现多端远程控制；配置定时任务，自动每日推送 AI 资讯、文件总结等。
 
          
这份文档可直接保存为 ，本地查看、分享发布均无问题，跟着步骤做，新手也能一次部署成功！
 
          
 
         
        
       
      
     
    
   
  
  

                    


                    


                    

                        

                            

                                小讯
                            

                            

                                

                                    
                                        
                                    
                                

                            

                        

                    

                


                

                    
                    
                    

                        
                        

                             上一篇
                            2026-03-21 23:01
                        

                    

                    
                    


                    
                    
                    

                        
                        

                            下一篇 
                            2026-03-21 22:59
                        

                    

                    
                    
                


                

                    
相关推荐

                    
                

                

                    

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