OpenClaw保姆级安装与常见问题解决(MAC&WIN)
本文介绍了OpenClaw在Windows和MacOS系统下的安装配置流程。主要内容包括:1)安装Node.js运行环境;2)通过官网命令安装OpenClaw;3)配置模型供应商和通信方式;4)飞书插件的安装与权限配置;5)网关设置及常见问题解决方法;6)飞书应用的事件回调配置;7)测试对话功能及网络搜索配置。特别针对Windows用户提供了兼容性问题的解决方案,并详细说明了飞书机器人权限的批量导
前言
本文章的安装适用于windows用户 和 MacOS用户 放心食用 制作不易劳烦您点个赞+收藏 感谢
一.环境配置
如果已经安装可跳过
1.安装node.js(openclaw的运行环境)
链接
https://nodejs.org/zh-cn?spm=a2ty02.30260236.d_text_model_experience.6.58fd74a1PEO7zF
安装流程
- 双击安装文件
- 按向导提示进行安装
- 务必勾选 “Add to PATH” 选项(Windows 用户尤其注意)
- 完成安装
2.验证安装结果
打开终端(Terminal)或命令提示符(Command Prompt),依次输入以下命令:

二.OpenClaw的安装
1.打开官网
2.找到以下命令并运行

打开终端运行
iwr -useb https://openclaw.ai/install.ps1 | iex
3.安装中依次选择配置如下



3.1模型供应商选择(我选的是千问)

3.2弹出登录页面并且登录

3.3回到终端 依次选择如下

3.4这个选择是通过什么通信方式控制你的电脑
我使用的飞书

3.5安装飞书插件
如果是Windows的话建议先跳过(因为下载的话会报错 Windows 系统的兼容性 Bug)
执行的npm 在Windows 上,实际上执行的程序叫 npm.cmd

windows用户另外启动一个终端 运行以下命令
1.安装飞书插件
npm install @openclaw/feishu
2.启动飞书插件
openclaw plugins enable feishu
3.查看插件启动情况
openclaw plugins list
![]()
3.5配置skill
也可以跳过 后期都可以自行配置

3.7选择钩子
可以随便选 建议选上后两个

3.8配置网关
选install或者reinstall

如果你的openclaw下载路径有中文的话 比如你的用户名 网关会启动失败
解决方法
win + R 输入以下命令

进入管路 然后更改系统区域设置

勾选如图选项 随后重启电脑

之后运行以下命令重新过一遍上述步骤
openclaw onboard
3.9成功之后进入以下web UI 界面

测试能否正常对话

4.配置飞书
4.1依次运行以下命令和选择配置
openclaw config




windows安装还是会报错(windows下的bug)

4.2正常情况下会让你输入app id和密钥
windows下如何进行接下来的配置呢?
来到web管理界面的频道可以配置

所以windows用户可以跳过

4.3申请飞书app id和密钥
进入以下链接
https://open.feishu.cn/app?lang=zh-CN
创建应用


随后一定要点击添加机器人按钮

点击左侧栏会有app id 和密钥了

来到openclawd的web管理端然后 复制粘贴进去id和密钥 选择以下配置然后保存

最后一步选continue

4.4开通权限
回到飞书开放平台 点击批量导入

4.5导入以下权限
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": [
"aily:file:read",
"aily:file:write",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
具体可见github 链接https://github.com/AlexAnys/openclaw-feishu
4.6随后配置事件与回调

4.7问题点如图(未建立链接)

原因分析 是因为openclaw配置完成之后没有重启
运行以下命令
openclaw gateway restart
重启之后再点击保存
4.7.1添加事件

im.message.receive_v1

4.7.2回调配置
保存

4.8创建版本并且发布

注意版本号格式 并且保存确认发布

飞书配置完成
5.测试
5.1打开飞书
你会收到以下消息 没有的话 直接搜索openclaw

点击打开应用
5.2发送消息
你会收到以下消息

5.3解决问题
在终端中运行最后一条命令
openclaw pairing approve feishu 码
运行完之后再发消息 就能正常回复了
5.4无法网络搜索问题

5.5配置brave AK
提示:
订阅brave需要钱和国外银行卡 没有需求本文可以到此为止 可以试着安装各种skill
进入以下链接
没有账户可先注册 后登录


复制申请的AK
打开终端
再次运行以下命令
openclaw config
这个页面选择web tools


之后就可以配置brave 的 AK了
随后按照指示结束配置
重启openclaw
openclaw gateway restart
此时就可以联网搜索了
DAMO开发者矩阵,由阿里巴巴达摩院和中国互联网协会联合发起,致力于探讨最前沿的技术趋势与应用成果,搭建高质量的交流与分享平台,推动技术创新与产业应用链接,围绕“人工智能与新型计算”构建开放共享的开发者生态。
更多推荐


所有评论(0)