乐于分享
好东西不私藏

OpenClaw 完整部署教程

OpenClaw 完整部署教程

OpenClaw完整部署教程

从零开始,一步一步,完成OpenClaw的安装与飞书机器人的配置

 因为限制,后台回复关键词,获取链接。

 或者看原文

很多人在安装OpenClaw时,搜到的教程都是代码一堆一堆,然后让你在电脑的PowerShell里运行,结果你一开头,满屏红字报错,然后就不知道该怎么办了。

为什么呢,因为你的资源还没有准备好!

本篇完全以小白视角,带你走进OpenClaw的安装,一步一步的让你完成本地部署,你只需要做复制粘贴就好。

电脑配置没有太高要求,我的是Intel CPU、24G内存、1T硬盘、win11 64位操作系统。

当然,不想本地折腾,也有现成方案可以体验,推荐链接地址如下:

如果此时你还想继续拥有自己的小龙虾,那就随着我的步骤开始吧,

所有需要的文件我已打包放在夸克网盘,更新时间是20260325,可以提前准备好,避免你使用时因网络问题无法正常下载,

链接:

提取码:u8NL

当然在后面每个详细步骤里我也会放原地址,方便你安装时及时获取最新文件。

一、前置条件准备

1.申请大模型(必须)

其它平台的其实也都可以,我使用的是智谱BigModel,新用户注册可获得2000万Tokens大礼包,

链接

进去后注意,右上角点“财务”-“资源包”,可以看到所剩余的Tokens,

同时也发现赠送的数量其实也区分了模型资源包,这个很重要,在后面配置的时候需要注意,避免没有对应好导致很快的消耗完了。

右上角点“API Key”后可以看到自己的专属码,这里需要注意务必点新建,默认的是没法用的。

2.创建并配置飞书机器人(推荐)

其实在OpenClaw控制界面也可以进行沟通,只是使用其它软件对接的话会更加方便,推荐使用飞书。

打开飞书开发者平台,进行注册 

然后通过“开发者后台”-“创建企业自建应用”

添加应用能力栏,选“机器人”,

然后在权限管理里,输入 im:message,全选,“确认开通权限”,

再到事件与回调,事件配置里选“长连接”然后点保存,

紧接着在“添加事件”里,增加示例四条,

还是事件与回调,回调配置里也选“长连接”然后点保存,

然后点创建版本,进行机器人发布。

这个时候,我们的机器人就已经创建好了,在凭证与基础信息那里,就是它的身份ID和密钥secret了。

3.环境配置

1)安装Node.js®(必须)

官方链接

直接双击安装即可,我是把文件均装在D盘,所以后续的涉及安装位置的都需要改一下;当然也可以选默认C盘。

一路Next,有跳弹窗就点“是”,直到Finish。

之后会主动跳出PowerShell界面,自行安装补丁文件。

等待完成后,关掉重开,以管理员方式运行PowerShell (后面所有的均需要按此方式)

验证是否成功,输入

node -v

npm -v

小插曲:npm提示报错,输入set-executionpolicy remotesigned 后选Y,解决。

能正常输出版本号即表示已完成。

在当前的界面执行镜像安装,输入 npm config set registry https://registry.npmmirror.com

然后执行 npm config list

看到红框,说明配置成功。

安装pnpm工具,执行 npm install -g pnpm

2)安装Git工具(推荐,反正我用PowerShell没安装成功过)

下载地址 

注意如果是ARM设备,请选ARM64。

我仅修改了D盘,其它均为默认,一直点Next直到Install完成,有跳弹窗选“是”。

3)安装C++编译环境(必须)

官方链接 

直接安装,

过程中仅选择“使用C++的桌面开发”,

然后等待下载安装完成即可。

4)获取OpenClaw源码(必须)

官方链接 

从Code里选择下载ZIP文件,然后解压出来后放在D盘根目录下,同时需要修改文件名称。

二、OpenClaw配置

1.安装OpenClaw本体

执行 cd d:\openclaw\

然后 pnpm install

如果继续在PowerShell中安装,非常容易报错或卡住:

所以我们换工具,使用Git Bash,依然以管理员身份运行(后面所有的均需要按此方式),

执行

cd /d/openclaw

pnpm install

等待完成下载和安装。

2.构建OpenClaw

依次执行 pnpm ui:build

pnpm build

pnpm openclaw onboard --install-daemon

方向键选择Yes

选QuickStart

模型选择我们之前的Z.AI

选择Z.AI API key

右键粘贴上从智谱中复制的key码,

选择keep current,

channel选择飞书(如果不使用,可以选择跳过),

search provider选择跳过,

然后依次:

Skill位置先通过上下按键,然后点空格键选中,然后Enter,

选允许,

选recommended建议的,

到此,基本完成。

3.重新配置模型

关掉Git Bash,PowerShell窗口,重新管理员打开Git bash,

输入pnpm openclaw config,重新配置一下模型调用,

与前面重复操作,直到Z.AI auth method,

选Coding-Plan-CN,

把glm-4.5、4.6之类的都选上,带flash的不选,

然后其它的选continue,完成。

4.重启网关

输入pnpm openclaw gateway

此时应该就可以打开主控面板了,也完成了与飞书机器人的连接。

1)小插曲1

我此时仍然打不开,如下图

在PowerShell里按上图提示操作,之后就正常了。

2)小插曲2

此时我的飞书机器人还不能正常沟通,返回原因是需要配对,

在OpenClaw面板直接对话“检查机器人状态”,

然后在Git Bash中按操作执行,完成后机器人就真正正常了。

三、写在后面

1.电脑重启后如何再次使用小龙虾

OpenClaw完成本地部署后,总的来讲还是需要本地电脑一直运行才能支撑的,

管理员权限打开Git Bash,cd打开openclaw文件夹,

输入 pnpm openclaw gateway,网关启用后,就可以通过网页打开控制台了。

2.Token不够用怎么办

上述已经将模型glm-4.5、4.6的都加载了,

对照Z.AI里的资源包,合适的调用即可;

在OpenClaw控制面板-代理里也可以手动设置,设置完成后记得点保存。

当然这些都是免费体验的,用多了可就得自己充费了。

3.常规问题可以在哪里找答案

优选OpenClaw本身对话框,

同时豆包也不错,但不能全信,更改内部文件时记得提前备份一下原文档。

4.其它建议

可以把一些常规网址添加收藏,留作备用。