10分钟部署openclaw教程,不使用官方脚本,国内网络,windows系统快速体验openclaw
10分钟部署OpenClaw教程:绕开官方脚本,搞定国内网络环境
今天咱们不走寻常路,聊一个快速上手的实战方案。如果你受限于国内网络环境,或者单纯想跳过官方脚本,亲手把OpenClaw搭建起来,那么下面这套流程,可能正是你需要的。整个过程思路清晰,一步步来,十分钟左右就能见到成果。
第一步:安装Node.js运行环境
这是所有事情的基础。直接访问Node.js官网,下载并安装对应你操作系统的版本。这里提供一个当前稳定的Windows 64位版本链接作为参考:
https://nodejs.org/dist/v24.13.1/node-v24.13.1-x64.msi
第二步:通过Gitee获取项目源码
由于直接从GitHub克隆可能会碰到网络问题,一个聪明的做法是利用Gitee这类国内平台“中转”一下。操作很简单,在Gitee上找到项目的镜像仓库,比如目前这个:
git clone https://gitee.com/x55/openclaw
第三步:准备构建工具与环境
源码下载解压后,进入openclaw-main目录。首先,我们需要一个更高效的包管理工具,在终端里执行:
npm install -g pnpm
第四步:安装项目依赖
接下来,使用pnpm来安装项目运行所需的所有依赖库。根据你的网络状况,这个过程大概需要十几分钟,耐心等待即可。
pnpm install
第五步:执行项目编译
依赖安装完毕,就可以正式编译项目了。运行构建命令,将源代码转换为可执行的文件。
pnpm build
第六步:验证部署成果
好了,最核心的构建工作到此完成。怎么验证呢?查看一下版本号是个好习惯。这里有个关键点:之后所有操作中,使用node dist/entry.js这个命令,就完全等同于直接使用openclaw命令。
node dist/entry.js --version
第七步:初始化项目配置
现在开始进行首次运行配置。执行初始化命令,按照提示完成必要设置。
node dist/entry.js onboard
第八步:启动服务网关
配置完成后,便可以启动核心服务了。这里注意,所有生成的配置文件默认都存放在C:\Users\你的用户名\.openclaw\这个目录下。
node dist/entry.js gateway
第九步:安装与管理插件
OpenClaw的扩展能力很大程度上依赖于插件。安装方法非常简单:只需要将下载的插件包解压,放到项目的skills文件夹内就行。通常,你会在里面看到几个官方自带的示例插件。
第十步:解决管理页面访问问题
最后,访问本地管理页面时如果遇到类似“1004”这样的错误,别慌。问题往往出在身份验证上。你需要打开前面提到的配置文件,找到里面自动生成的token值,然后像下面这样拼接在访问地址后面:
http://127.0.0.1:18789?token=自动生成的token值放这里
这样一来,服务部署和基础访问就全部打通了。整个流程注重直击要点,避开了常见的网络坑点,希望能帮你顺利跑起来。