1. OpenClaw(小龙虾)项目概述
OpenClaw(昵称"小龙虾")是一款基于Node.js开发的AI助手工具,它提供了终端(TUI)和网页(Web UI)两种交互界面。作为一个本地化部署的AI解决方案,它特别适合想要在Windows环境下快速搭建AI助手的国内用户。我在实际部署过程中发现,官方文档对新手不够友好,特别是在国内网络环境下会遇到各种依赖安装问题。经过多次尝试和踩坑,我整理出了这份最适合国内新手的部署指南。
这个项目的核心价值在于:
- 完全本地运行,无需依赖外部API密钥
- 支持Qwen等开源大语言模型
- 提供双界面操作方式(命令行+网页)
- 针对国内网络环境优化了安装流程
整个部署过程大约需要30分钟,只要跟着步骤操作,即使没有Node.js基础也能顺利完成。下面我会从环境准备开始,详细说明每个环节的操作要点和避坑技巧。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与工具安装
2.1 Node.js安装与配置
Node.js是OpenClaw运行的基础环境,相当于整个系统的"发动机"。它让JavaScript代码能在你的电脑上直接运行,而不是只能在浏览器中执行。
2.1.1 下载与安装
- 访问Node.js官网下载页面:Node.js官方下载
- 选择"Windows安装程序(.msi)"的LTS版本(长期支持版更稳定)
- 下载完成后双击安装包,保持默认设置,连续点击"下一步"完成安装
注意:安装路径不要包含中文或特殊字符,使用默认的"C:\Program Files\nodejs"最为稳妥。我在测试时曾因路径包含空格导致后续模块安装失败。
2.1.2 验证安装
安装完成后需要确认Node.js和npm(Node.js的包管理器)能正常工作:
- 按下Win+R,输入"cmd"打开命令提示符
- 依次执行以下命令检查版本:
bash复制node -v
npm -v
正常情况会显示类似这样的版本号(具体数字可能不同):
code复制v18.16.0
9.5.1
如果提示"不是内部或外部命令",说明环境变量未正确设置。这时需要:
- 右键"此电脑"→"属性"→"高级系统设置"→"环境变量"
