Mac安装openclaw写飞书云文档
🎯前言
OpenClaw的安装教程有很多,最近官方支持了飞书channel使得一些过于复杂的教程不再有必要。然而,跟随官方教程走也不尽完美,比如社区中报道的重复插件warning的问题:Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate
plugin id detected; later plugin may be overridden
因此,本文结合官方教程,整理了简洁的openclaw安装,绑定飞书机器人并按要求写飞书云文档的过程。
1. 安装node和openclaw:
操作:
终端输入
#安装 node brew installnode#检查版本node-vnpm-v#安装openclaw (使用时,网络问题需要自行解决,调成tune模型可用)npminstall-g openclaw@latest #PS: 卸载命令 openclaw uninstall npmrm-g openclaw 结果

坑点:
- npm安装时的网络问题,建议自行解决或私聊解决方案。
2. 初始化
操作
模型还没配置好,选第二个:
![[图片]](https://qiniu.meowparty.cn/coder.2023/2026-03-21/54d78bf3afc74e7cb2968dcb6b696e9c.png)
后续一系列选择:
![[图片]](https://qiniu.meowparty.cn/coder.2023/2026-03-21/0f1c3541f1c543dcb2007ab8fcfb392e.png)
Skill可以现在配置,也可以后面再配
![[图片]](https://qiniu.meowparty.cn/coder.2023/2026-03-21/a1eb828beae84dfc90d053027ca515da.png)
!!,注意:Channel选择Skip for now.
![[图片]](https://qiniu.meowparty.cn/coder.2023/2026-03-21/2620d3a0d61943ca804e208a45bf919b.png)
选择Yes->QuickStart

终端输入
#初始化,之后都是空格选择,回车确认 openclaw onboard --install-daemon 坑点:
- 如果在这里配置了飞书,会安装一个飞书插件,而2.13版本原生有飞书插件,所以后面每次都会有烦人的warning。
3. cursor (vscode)随时查看文件
目的:随时OpenClaw实际使用时产生的文件,例如配置文件openclaw.json,agent行为文件memory.md,SOUL.md等,方便知道其真实状态。
操作:
终端输入
#cursor打开文件夹(随时查看底层文件)open-na Cursor --args /Users/xxx/.openclaw 结果:

4. 飞书配对:
操作:
- 首先,在官方教程https://docs.openclaw.ai/zh-CN/channels/feishu页面,完成第一步:创建飞书应用的前五步:
- 打开飞书开放平台
- 创建应用
- 获取应用凭证
- 配置应用权限
- 启用机器人能力
- 在官方教程https://docs.openclaw.ai/zh-CN/channels/feishu页面,继续完成第一步:创建飞书应用的第6和7步:
- 配置事件订阅
- 发布应用
重启网关:
openclaw gateway restart 浏览器打开http://127.0.0.1:18789,在此处输入创建飞书应用时得到的app id和app secret,点击save


然后,启动自带的飞书插件
openclaw plugins enable feishu 结果:
- 上述过程完成了官方教程的第一步和第二步。
- 不过在进行对话前,我们需要配置语言模型
坑点:
- 如果按照官方教程采用openclaw channel add进行安装,还是会重复安装插件并报错。
5. 配置语言模型:
操作
重启gateway
openclaw gateway restart 我使用的是Minimax的coding plann,49块钱一个月的,因此选择了这个。你也可以使用其他的模型
![[图片]](https://qiniu.meowparty.cn/coder.2023/2026-03-21/5ff8ad67fc8e462a96b72a146b937279.png)
选择local—>Model
![[图片]](https://qiniu.meowparty.cn/coder.2023/2026-03-21/44b523c7fb17407d93ec6430a2e6a463.png)

终端输入
openclaw config 结果
- 配置完成即可
6. 飞书验证:
操作
- 在命令框配对,即可
首先,在飞书对应用随便发一条消息,得到回应:

openclaw pairing approve feishu <配对码>结果:

写飞书文档:
![[图片]](https://qiniu.meowparty.cn/coder.2023/2026-03-21/1439cd0398bc44488a7018f05ee8a89e.png)
