乐于分享
好东西不私藏

非技术人员安装 Windows 版 OpenClaw 全攻略

非技术人员安装 Windows 版 OpenClaw 全攻略

从零开始,在windows系统安装你的 AI 助手

一、什么是 OpenClaw?

OpenClaw 是一个强大的 AI 助手框架,可以连接各种 AI 模型(如 GPT、Claude、DeepSeek 等),并通过飞书、微信等多种渠道与你对话。

简单来说:安装后,你就能在飞书里拥有一个 7*24小时在线的 AI 助手!


二、安装前准备

 (一) 系统软件要求

1.操作系统:Windows 10 或 Windows 11

2.安装Node.js

访问nodejs官方,直达链接:https://nodejs.org/  选择最新版下载即可,文件名为msi,我下载的版本为v24.16.0,同时会将docker和npm一起安装掉,可以通过。

3.git安装

打开Git官网,直达链接:https://git-scm.com/downloads,选择对应系统的版本,下载git安装包。一般下载X64。

4.VisualStudio安装

下载地址:https://visualstudio.microsoft.com/zh-hans/,下载之后按步骤安装,在工作负载中选择“使用C++的桌面开发”,以及右侧的“windwos 11 SDK”(我安装时不需要选择),直至安装完成。

5.管理员身份打开powershell

按快捷键“+R”,弹出运行小窗,在打开框中输入“powershell”,然后再按“ctrl+shift+enter”三个键,会进入管理员身份打开的powershell界面。

6.检查软件安装情况

在powershell中分别输入以下代码,检测node、npm、git的版本情况。如果电脑在之前安装过软件,可以将5、6两个步骤放在第2步执行。

node -v
npm -v
git -v

  (二)需要准备的信息

在开始之前,请准备好以下信息:

1.AI 模型 API 密钥(任选其一)

(1) 选择模型
OpenAI (sk-…)、DeepSeek (sk-…)、智谱 AI (GLM)、或者其他兼容 OpenAI 格式的 API均可。此次说明用的是智谱AI。
(2) 获取密钥
登录相应模型的开放平台,部分平台会给新注册用户免费使用量,也可以自行购买。智谱AI地址:https://www.bigmodel.cn/,在API Key栏目中,“新建API Key”后复制新建的“API Key”才能被openclaw调用,同时还得保证有智谱的资源包,且有可用余额。
(智谱AI开放平台首页)
(智谱AI的API Key界面)
(智谱控制台账务-资源包管理-我的资源包)

2.飞书应用凭证(如果在飞书中使用,目前我只会在飞书上用)

(1) 创建应用
进入飞书开放平台,https://open.feishu.cn/?lang=zh-CN,注册后创建企业自建应用,填写应用名称、应用描述,选择颜色就可以创建成功。
(2) 获取App ID 和App Secret
点击“凭证与基础信息”可以复制App ID 和App Secret,复制下来备用。
(3) 创建机器人
点击“添加应用能力”,选择右侧机器人进行“添加”。
(飞书应用添加机器人)
(飞书应用添加机器人完成的状态)

三、openclaw本地安装

使用 npm 安装

因为前面已确定安装了 Node.js,所以在管理员身份打开的powershell界面输入以下代码进行安装,安装完成后通过代码查询版本。(我安装的是2026.6.1版本)

npm install -g openclaw@latestopenclaw --version 

四、openclaw配置

虽然前面安装好了openclaw但是还无法使用。需要对openclaw进行配置。配置代码如下:

openclaw onboard --install-daemon

之后,跟着提示一项一项进行配置。

1. 默认个人使用等配置

第一项,通过左右键选择“Yes”;

第二项,选择“QuickStart”,快速安装;

2. 模型选择

通过上下键选择模型,我们要选的智谱模型不在展示区,光标移动到“More…”,再点击回车键;

(如果没有模型也可选择Skip for now,以后再配置)

再按上下键,可查看更多模型,并选择“Z.AI”即智谱模型;

回车后,选择智谱模型的类型,需要选择“Coding-Plan-CN”;
再选择默认模型型号,我选择的是glm-4.7。因为在我的资源包中,当时只有4.7可用。
根据指示输入API key即可。(忘记截图了)

3. 配置渠道

选择渠道进行配置,我目前使用的是飞书。选择后会自动进行安装,完成后进入下一步。也可以先Skip for now,后续再添加。
配置过程中,需要输入AppID和App Secret,只要正常输入并操作即可。

4. 其他配置

Search provider选择默认的即可。
可以先不配置skill,直接选择No
Hooks配置为session-memory,要前面按向下键选择,然后再按空格键,即为选中,再按Enter键配置。
Hatch Agent方式,默认选择在终端即可。
完成。

五、飞书权限配置

1.订阅方式
进入开发者后台,点击对应应用,进入“事件与回调”,将订阅方式选择为“使用长连接接收事件”。
2.添加事件
在“事件与回调”页面中,点击“添加事件”,通过输入“im”来搜索与消息和群组相关的事件,选择以下分类:

事件名称

事件标识

说明

接收消息

im.message.receive_v1

接收用户发送的消息(必需)

消息已读

im.message.message_read_v1

用户已读消息通知(可选)

消息撤回

im.message.recalled_v1

用户撤回消息通知(可选)

机器人进群

im.chat.member.bot.added_v1

机器人被拉入群聊(可选)

机器人被移出群

im.chat.member.bot.deleted_v1

机器人被移出群聊(可选)

3.权限管理
在“权限管理”模块批量导入以下JSON内容:
 {   "scopes":{     "tenant": [        "aily:file:read",        "aily:file:write",        "application:application.app_message_stats.overview:readonly",        "application:application.bot.operator_name:readonly",         "application:application:self_manage",        "application:bot.menu:write",        "cardkit:card:write",        "contact:contact.base:readonly",        "contact:user.employee_id:readonly",        "corehr:file:download",        "event:ip_list",        "im:chat.access_event.bot_p2p_chat:read",        "im:chat.members:bot_access",        "im:chat:readonly",        "im:message",        "im:message.group_at_msg:readonly",        "im:message.p2p_msg:readonly",        "im:message:readonly",        "im:message:send_as_bot",        "im:resource"    ],"user": ["aily:file:read","aily:file:write", "im:chat.access_event.bot_p2p_chat:read"         ]     } }                      
贴粘后效果如下图,不能有红色波浪线,如果出现红色波浪线,说明语法有误,需要检查,一般来说就是前一句没逗号、符号是中文之类。也可以让AI帮你检查。
4.发布版本
点击“版本管理与发布”模块,再选择“创建版本”,进入版本创建模块。
在这里进行版本号、版本描述的设置,设置完成点击“保存”即可。
到这里飞书就配置完成啦!


六、启动服务

1.启动openclaw

管理员身份打开的powershell界面输入以下代码:

openclaw gateway restart

回车运行后,会自动打开另一个代码框:

2.打开飞书

在飞书找到你命名的应用名称(我的应用名叫“小墨的AIbot”),并跟其对话,如果有回复,则是完成配置啦!

我这边其实是状况百出~~

一开始机器人回复只能显示一行,无法换行展示。百般折腾后,估计是不是飞书插件不对,所以找了个代码进行修复及重新安装,再重新启动,就正常啦!代码如下:(个人觉得,最后一条代码有效)

#安装官方插件openclaw plugins install @openclaw/feishu#修复飞书插件npx @larksuite/openclaw-lark doctor --fix#更新官方插件npx -y @larksuite/openclaw-lark install

再然后,换模型没换成功,导致我的龙虾完全瘫痪,无奈之下只能对龙虾重新设置。好在,重新设置后能正常使用了,等后面空了,我再研究换模型。

3.开始工作

最初,我用它来做产品竞品分析,并生成word放到指定目录,它完全做到啦~

由于openclaw的配置太烦杂,我也让他帮我做了一个龙虾壳,但是感觉不是很专业,需要不断地去训练和调优,只出了个雏形,就没深究了。

整体来说,跟Saas的AI使用很像,但是,很耗token!

由于我这个飞书号是刚创建的,还没加好友,所以没法群聊,等后面加上好友,我再研究群聊的玩法。


七、安装Skill

这是clawhub网站https://clawhub.ai/,可以通过网站搜索skill进行安装。
(clawhub首页)
(skill页面)
(skill详情页,红框处会显示其安装方法)
1.常规skill安装

管理员身份打开的powershell界面输入以下代码进行skill安装:

#安装clawhubnpm i -g clawhub#必装skill安装 openclaw skills install skill-vetteropenclaw skills install self-improvingopenclaw skills install openclaw-tavily-searchopenclaw skills install weatheropenclaw skills install find-skills-skill
2.专项技能skill安装(公众号为例)
搜索wechat相关的skill
主要安装以下skill及代码:
#微信公众号中文版openclaw skills install wechat-mp-cn#微信公众号文章搜索openclaw skills install wechat-article-search#微信发布openclaw skills install wechat-publisher#微信公众号文章创建openclaw skills install wechat-article-creator#微信自动回复openclaw skills install wechat-auto-reply
在飞书交互,让它帮忙写文章。
(它要求授权)
(飞书授权)
(它要求更多授权,继续飞书授权即可)
(本想注册新号发文,后来放弃了,告诉它ID和secret,它要求加白名单)
(没token了!!!充值后才正常运行)
(小龙虾自动生成的文章,感觉还是太low了)

以上是我对小龙虾安装和使用的全过程~供大家参考!边用边探索吧