教你从GitHub 上安装OpenClaw 小龙虾(零基础小白向)

上一期教了怎么登上GitHub,从上面下载项目这期来教一下怎么安装OpenClaw小龙虾(注意后续使用需要大模型api 如果有可以替换自己的api 没有后面也有教程告诉你怎么获取api)

 前置准备：Windows 环境搭建（必看）

Windows 系统最容易出问题的就是环境，这一步一定要仔细做！

必须安装的软件（按顺序）

软件	版本要求	下载地址	安装注意事项
Node.js	22.0.0+（必须！）	https://nodejs.org/	选择LTS 长期支持版，安装时一定要勾选 “Add to PATH”
Git	最新版	https://git-scm.com/download/win	安装时全部默认选项即可
Python(非必要)	3.10-3.12	https://www.python.org/downloads/	可选：依赖安装出现 node-gyp 编译报错时再安装，正常安装可跳过

第一步安装Node.js

打开官网https://nodejs.org/

点击获取

查看右上角确认选择的是LTS,因为龙虾需要的版本是22.16以上的版本只有是这个版本以上都支持,点击获取安装程序,等待下载完成(右边的是压缩包)

打开安装程序

下一步

勾选然后下一步

选择安装的位置

点击这个小加号勾选Add to PATH然后下一步

不需要勾选点击下一步(勾选是安装Chocolatey、Python 和 Visual Studio Build Tools我们不需要且5个G左右浪费时间)

点击安装等待安装完成

点击Finish关闭页面(关闭后重启电脑必须)

键盘win+R输入cmd后回车

会打开一个命令窗口输入node -v 后回车,再次输入npm -v

显示这个就是安装成功了Node的版本即对应的npm的版本(显示安装的版本后关闭这个命令窗口)

第二步安装Git:

1. 下载安装包

官方下载地址：https://git-scm.com/download/win

打开页面后会自动识别你的系统，直接下载最新版的 64-bit 安装程序即可

打开下载的安装包,点击下一步

取消勾选无需查看版本说明,点击右下角 Finish 按钮，结束安装

验证安装是否生效,打开一个 PowerShell / CMD 窗口(已打开的旧窗口无法读取新写入的系统环境变量）输入命令:

git –version

回车后输出版本号:

第三步安装OpenClaw:

然后运行之前教程安装的Watt Toolkit(steam++)进行Github加速(只勾选Github)

然后在一个容量充足的盘符新建一个命名为Project的文件夹

然后在Project里面新建一个命名为OpenClaw的文件夹(需要纯英文不然会报错)

查看OpenClaw文件夹注意路径不要出错

在开始菜单搜索PowerShell,以管理员身份运行不然可能会出现权限不够的情况

然后在新打开的命令窗口输入: cd D:\Project\OpenClaw回车(进入项目路径)

第 1 步：克隆源码到当前空文件夹(复制后回车需要等待一段时间)

git clone https://github.com/OpenClaw/OpenClaw.git .

第 2 步：配置 npm 全局国内镜像(Steam++ 不加速 npm)

npm config set registry https://registry.npmmirror.com

没有结果就是成功了

第 3步：安装 pnpm 包管理器

npm install -g pnpm

终端输出版本号信息，无红色报错

第 4 步：配置 pnpm 国内镜像

pnpm config set registry https://registry.npmmirror.com

执行后没有任何文字输出,终端直接回到 PS D:\Project\OpenClaw> 

第 5 步: 设置浏览器组件临时下载源

$env:PUPPETEER_DOWNLOAD_HOST=”https://registry.npmmirror.com/mirrors”

执行后没有任何文字输出，终端直接回到命令提示符

第 6 步: 安装项目全部依赖(这一步等待时间较长属于正常现象)

npm install

过程中会滚动显示下载、解析依赖的进度条

最终结尾没有红色 error 字样即为成功

过程中出现黄色的 warn 警告是正常现象，不影响安装结果，只要没有红色 error 就没问题

第 7 步: 复制生成配置文件

copy .env.example .env

无额外输出，直接回到命令提示符即为成功

第 8 步: 构建项目(首次编译时间会稍长属于正常现象)

pnpm build

终端会输出编译打包进度，最终显示构建完成，全程无红色 error 报错

第 9 步: 启动 OpenClaw 服务

pnpm start

已成功启动

第 10 步:完成基础初始化(不要关闭窗口待会还要回来)

在当前终端的输入区域输入 yes 并回车，向导会自动完成本地工作目录创建、网关初始化等基础环境配置(等待配置完成)

配置 DeepSeek API

第一步: 获取deepseek api

官方网址: https://www.deepseek.com/

点击api开放平台

登录账号后点击充值

随便充值多少deepseek的api很便宜

充值好后点击api keys

创建api keys

输入一个名称点击创建(因为你可能后面会创建很多api keys名字不要记混)

复制你的api keys(注意api keys一定不要发在公共平台会被别人盗用)

回到对话框设置 API Keys

set openai api key 你的sk开头密钥

绑定官方兼容接口地址

set openai base url https://api.deepseek.com/v1

指定默认调用模型（二选一）

通用低成本：set default model openai/deepseek-v4-flash

代码 / 长文档深度推理：set default model openai/deepseek-v4-pro

根据实际使用需求来这里不做推荐

输入yes保存默认模型配置

校验配置

status

输出内容中出现 OpenAI 配置栏，显示密钥、baseUrl、默认模型即配置成功

打开可视化网页

复制到浏览器打开可能会有出入大部分情况都是这个

http://127.0.0.1:18789/

复制到浏览器打开可能会出现这种情况

在未关闭的终端输入: openclaw dashboard

执行后会自动弹出带网关令牌的浏览器页面，无需手动填写 URL 和令牌，直接自动连接成功

注意可能会连接失败如果失败看下面

确保 Gateway 正在运行

在 新的PowerShell 中执行(注意需进入正确的目录cd D:\Project\OpenClaw)：

openclaw gateway restart

停止并重启Gateway

查看是否重启成功

openclaw gateway status

在输出的末尾部分，找到这两行：

Runtime: running （表示进程在运行）

Connectivity probe: ok （表示网络连接正常）

如果同时看到这两行，说明服务已经完全恢复，可以正常使用

部署途中有什么问题可以私信我