win10教育版中本地化安装openclaw+集成飞书详细操作步骤

安装环境

1.1 操作系统

win10教育版虚拟机,内存8G,硬盘80G,CPU 2X2。系统信息如下图:

1.2 准备依赖包

在此电脑上安装了2026.3.2的openclaw。开始按照网上方法,安装了node 22.22.0,在安装openclaw时报错信息是node 的1:1出错。后来安装node 24.14.0后再安装openclaw成功了。

需要事先准备的依赖包为nvm-setup.exe(1.2.2)、node-v24.14.0-x64.msi(也可以不下载此依赖包,通过nvm install 24 在线安装)、Git-2.53.0-64-bit.exe。获取这三个依赖包后,分别按顺序右键选择使用管理员权限安装。安装成功后分别使用nvm -v、node --version、git -v查看版本号。

nvm-setup.exe(1.2.2)下载地址: 链接:https://pan.quark.cn/s/34b82e583839?pwd=G6kh 提取码:G6kh

node-v24.14.0-x64.msk下载地址:链接:https://pan.quark.cn/s/9f5f7a977493?pwd=BpwL 提取码:BpwL

git-2.53.0-64.exe 下载地址: 链接:https://pan.quark.cn/s/edbbf7909d6f?pwd=YSZA 提取码:YSZA

开始安装

2.1 以管理员方式打开powershell

按win+s,搜索到powershell,右键选择管理员运行。

2.2 在安装前设置允许本地或网络上的脚本在本机上执行或跳过。两条个命令如下(出现确认选择项时,选择A):

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExcutionPolicy Bypass

2.3 开始执行openclaw在线安装(需连网)

输入如下命令开始安装。

iwr -useb https://clawd.bot/install.ps1 | iex

等待15分钟左右,若没有出现安装成功提示,可按回车键出现安装成功的信息(若出现报错,需看法出错原因,查找对应的解决方法。本人安装时没有报错)。如下图所示:

2.4 进入配置界面

安装成功后,会自动执行openclaw onboard进入配置界面。全程英文,需看清楚主要含义,并且通过方向↑ ↓ ← → 键选择所述选项后,敲回车键执行。

如果不小心关掉窗口,可重新以管理员方式打开powershell后,输入:

openclaw onboard --flow quickstart 进行配置

1、安全风险提示

告知使用openclaw可能有的一些风险提示。默认是绿色>在No前面,需通过← 移到Yes,然后回车。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

2、模式选择

在Onboarding mode界面选择QuickStart。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

3、选择需要使用的AI模型

在Model/auth provide界面列举模型供选择。通过↑ 或↓选择自己所使用的模型(选择模型前需具备所选择模型的API 账号和key,可以事先在能访问的模型平台上注册,并查到所注册账号对应的API 账号 & key并记录下来。也可以在选择后弹窗的窗口中立即注册和登录,登录通过后会有成功的提示界面。本人使用的是Qwen模型,在弹出的窗口中注册并把它们记录在另外的表格处。另:忘记截图了,操作时仔细看明白英文意思就可以按引导操作)。

4、看清提示选择和输入API账号和key

在弹窗的界面上输入API账号和key,若登录功能会有成功的提示,进入选择channel配置。本人是使用飞书作为沟通的channel,但由于本人没选择Windows 通过WSL2的安装方法,此处先不选择Feishu跳过channel,而是把选项移到Skipf for now向下配置,后面再配置Feishu。

5、 进入Skill选择阶段

此处也先不选择Skill,待安装完成后在UI界面上选择Skill。选择跳过此步。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

6、开始安装并启动网关

选择完成回车就开始安装配置并启动网关,会自动新开一个Powershell窗口执行,任其执行,若有提示需看明白是什么样情况。本人在安装时一直正确执行,没有报错之类的异常信息。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

7、浏览器自动打开控制台

openclaw自动调用浏览器打开控制台界面。后面可以通过http://127.0.0.1:18789/访问和配置。

8、验证

在左侧栏里选择Chat(聊天),在中间下部的Message(…)随意输入后回车,若能有正常回复,说明安装成功。否则,需要给出的提示进行排查。

配置连接飞书

配置连接飞书的网上资料挺多的,我也是对照操作的,请允许本人偷个懒,省得截图和撰写了,就把自己成功操作的过程从不同参考网站上搬运合并了。若涉及作者不同意,麻烦告知删除。

主要步骤:

1、在飞书开放平台(https://open.feishu.cn/。需先注册,获取APPID & APP Secret)中创建应用–>配权限/事件/回调–>发布版本–>回到openclaw中填写App ID & APP Serect。

2、在Openclaw 中安装飞书的插件。

1.1 进入飞书开放平台

通过访问https://open.feishu.cn/进入飞书开放平台,点击右上角的开发者后台。若没注册账号,需要先注册账号。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.2 创建应用

在开发者后台界面的左侧点击修建企业自建应用。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.3 获取自己的应用凭证

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.4 给创建的应用添加机器人

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.5 给应用配置权限

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.4 事件订金阅

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

若出现异常,可通过openclaw gateway查网关相关信息是否存在和填写正确。

1.5 添加接收消息事件

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

1.6 发布版本

上述内容配置和选择好之后,点击左侧的版本管理与发布,输入相应内容后发布版本。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

2.1 在openclaw中安装飞书插件

在之前的powershell界面(也可以用管理员模式新开启一个powershell)。两种方法调用安装飞书插件。

第一种:openclaw config,一步一步到channel选项。(本人是通过这种方法)

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

选择Channels

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

选择配置连接

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

回后出现输入APPID和APPSecrect界面,看清楚后分别输入。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

选择飞书的接入域名

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

接受群组聊天

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

选择完成

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

在出现的界面中选择Yes

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

在出现的界面中选择open

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

在出现的界面中选择继续,配置完成。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

在powershell窗口中输入openclaw gatewat restart进行服务重启,让配置生效。再通过openclaw gateway检查所配置的飞书是否生效。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

2.2 在飞书中验证

在飞书客户端(手机端或电脑端,本人是在手机端),搜索配置时定义的机器人名称,搜索到后打开对话机器人。随意输入内容,检查是否有响应。若有响应,则搭建完成,其它更多功能自行了解增加。若响应出错,根据出错信息进行相应的排错,直到能正常响应。实在无法排查可恢复虚拟机重来(在安装openclaw前,最好把该虚拟机snapshot一下)。

访问Web控制面板

完成配置后,Powershell窗口底部会显示控制面板的链接。或者在浏览器中输入默认的配置控制面板界面地址:

http://127.0.0.1:18789

常用命令参考

openclaw onboard 重新进入配置向导

openclaw status 查看运行状态

openclaw health 健康检查(在控制面板的右 上角也有显示)

openclaw gateway start 启动服务

openclaw gateway stop 停止服务

openclaw gateway restart 重启服务

openclaw update 更新到最新版本

openclaw doctor 诊断异常

openclaw uninstall 卸载openclaw

写在最后

nclaw gateway start 启动服务

openclaw gateway stop 停止服务

openclaw gateway restart 重启服务

openclaw update 更新到最新版本

openclaw doctor 诊断异常

openclaw uninstall 卸载openclaw

写在最后

基本功能搭建成功后,剩下就是根据自身的需要,查找相关资料进行自学了。相信经常搭建,也具备查找资料自学的条件了。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐