文章目录
 
  
    
    
 
     
引言 
      
 
       
什么是 OpenClaw？
 
       
为什么选择 OpenClaw？
 
      
 
     
一、基础环境准备 
      
 
       
1. 安装 Node.js (v22及以上)
 
       
2.安装 Git
 
       
3. 解决 npm 被拦截（没报错跳过）
 
      
 
     
二、一键部署与唤醒“龙虾” 
      
 
       
1.全自动拉取与组装
 
       
2.醒龙虾与配置“大脑”
 
      
 
     
三、接入官方 机器人（可选） 
      
 
       
1. 领取官方机器人的“身份证”
 
      
 
     
2. 本地安装专属通信插件
 
     
3. 结果展示
 
     
总结
 
    
 
  
    
    
 
     
如果把各种大语言模型（比如 Qwen、DeepSeek）比作 AI 的“大脑”，那么 OpenClaw 就是为这个大脑量身定制的“躯干和神经系统”。它不仅能帮你管理这些大模型的接入，还自带了一个可视化的 Web 控制台，能够轻松连接各种外部社交平台（、Telegram 等），并赋予 AI 读取本地文件、调用外部工具的能力。
 
     
很多接触过 AI 开发的朋友都知道，如果我们想自己从零手搓一个带有记忆功能、能调用工具的 机器人，工作量是非常庞大的。你需要自己处理平台接口的对接、手写底层 ReAct 架构的逻辑、维护上下文记忆流、甚至还要自己写一个前端来监控它的运行状态。
 
     
今天这篇文章，我就带大家在 Windows 本地部署一下 OpenClaw ，并实战演示如何将它零基础无缝接入官方的 机器人！
 
     
 
      
OpenClaw 对底层环境有两个硬性要求：Node.js 版本必须 >= 22，并且电脑里必须装有 Git。
 
      
如果你缺少这两样，或者 Windows 权限没配好，后面的报错会让你怀疑人生。完成以下三步，确保安装一次过。
 
      
OpenClaw 是基于 Node.js 运行的。我们需要去官网下载最新的 LTS（长期支持）版本。
 
      
 
        
      
 
      
 
        
      
 
      
注：在双击安装、一路狂点“下一步”的过程中，如果遇到一个界面提示 “Automatically install the necessary tools…”（自动安装必要的工具，如 Python 和 C++ 编译环境），最好勾选它。很多 AI 相关的 Node.js 项目在底层需要编译 C++ 依赖，勾选这个能帮你省去未来 80% 的编译报错烦恼。
 
      
npm 在拉取 OpenClaw 的某些开源依赖时，必须调用本地的 Git 工具，否则会报 ENOENT (找不到文件) 错误。这里提供两种常用的安装方式：
 
      
方案 A：使用 winget 命令行一键安装
操作步骤： 右键以“管理员身份”打开 PowerShell，输入以下命令并回车：



 
      

        winget install Git.Git 
      
 
      
但是我在输入这条指令的时候出现报错，弹出一堆红字，报 "0x8a15000f :Data required by the source is missing” 的错误。
 
      
 
        
      
 
      
方案 B：官网下载安装包
操作步骤： 直接访问Git官网（https://git-scm.com/install/windows） ，下载 64-bit 的 .exe 安装包。







 
      
 
        
      
 
      
注：Git 安装完成后，请务必把你当前打开的所有黑窗口（PowerShell/CMD）全部关掉！ 然后重新打开一个新的窗口，输入 git -v。如果能输出类似 git version 2.x.x.windows.x 的提示，才说明系统真正识别到了它。
 
      
环境装好后，按理说我们应该验证一下。打开你的 PowerShell，输入 node -v，你应该能顺利看到刚刚安装的 Node.js 版本号。
 
      
 
        
      
 
      
解决办法：
我们只需要稍微放宽一点本地脚本的运行权限即可。
1.关闭当前报错的终端。
2.重新找到 PowerShell 图标，右键选择“以管理员身份运行”（这一步非常关键，普通窗口没有修改权限）。
3.复制并运行以下这行放行命令：
























 
      

        Set-ExecutionPolicy RemoteSigned 
      
 
      
按下回车后，系统会弹出一大段黄色的警告文字，问你是否要更改执行策略，输入大写字母 Y，然后回车确认。
 
      
 
        
      
 
      
保持刚才那个“以管理员身份运行”的 PowerShell 窗口处于打开状态，我们接下来所有的操作都在这里完成。
 
      
在命令行中，输入我们今天的第一条核心指令，把龙虾接回本地：
 
      

        npm install -g openclaw@latest 
      
 
      
敲下回车后，npm 会自动去云端把“龙虾”的所有零部件下载并拼装到你的电脑里。这个过程根据网速可能需要一两分钟。
 
      
注：在跑进度条的时候，终端里可能会弹出一堆黄色的 warn deprecated（警告老旧依赖）或者蓝色的 notice（提示 npm 有新版本）。不要慌，也不用管它们！ 这些都不会对程序运行产生任何影响。只要你最后看到类似 added 673 packages in 2m 这样的提示字样，就代表核心组件已经完美安装成功！
 
      
接下来，我们需要给它通电开机，并给它装上一个大模型（这里我们以接入强大的通义千问 Qwen 为例）。
 
      
继续在终端中输入启动初始化向导的指令：
 
      

        openclaw onboard 
      
 
     
    

注意：如果出现以下问题，请在直接将token一起复制进浏览器

http://localhost:18789/?token=一长串字母和数字

得益于腾讯 开放平台最近的原生支持，以及 OpenClaw 极其方便的插件系统，我们现在完全不需要手写任何复杂的收发消息接口，只需简单配置即可免费获得官方的机器人通道。

首先，我们需要去腾讯那边建立一个机器人的空壳，并拿到它的专属凭证。

拿到身份证后，我们要让本地的“龙虾”学会 的通信协议。

重新打开一个新的 PowerShell 窗口（建议依然是“以管理员身份运行”），输入以下指令，一键安装官方维护的 插件：

回到软件，可以看到新建的机器人已经被添加至您的消息列表中，并将会发送第一条消息。

我们可以尝试让他完成一些任务。

看来结果还是比较让人满意，大功告成！

到这里，我们已经成功避开了 Windows 环境配置的各种大坑，把带有 Qwen 大脑的“龙虾”顺利养在了本地，并且无缝接入了 。

但这仅仅是个开始。OpenClaw 最大的价值不在于陪聊，而在于它极强的本地工具调用能力。

现在你拥有了一个跑在本地的智能中枢，接下来最务实的玩法就是给它写点专属的工具。比如，你可以把以前写的 Python 脚本挂载给它，以后只需在 里发句指令，它就能自动帮你跑脚本，比如自动合并处理本地的一大堆 Excel 数据表，或者去抓取实时的金融行情数据做快速分析。

万事开头难，最折磨人的环境部署既然已经搞定，剩下的就是尽情发挥你的创意了！

如果你在实操中还遇到了其他奇葩报错，或者给这只龙虾开发了什么好玩的本地小工具，欢迎在评论区留言交流！