本文介绍了在 Mac 环境下安装 OpenClaw 并配置飞书机器人的完整流程。内容包括安装 Node.js 和 OpenClaw 依赖、初始化项目、配置语言模型、创建飞书应用及获取凭证、启动网关与插件配对等关键步骤。文中还针对插件重复警告、网络环境及本地文件查看等问题提供了优化建议与解决方案，帮助用户快速实现通过飞书云文档进行 AI 交互的功能。
OpenClaw 的安装教程有很多，最近官方支持了飞书 channel 使得一些过于复杂的教程不再有必要。然而，跟随官方教程走也不尽完美，比如社区中报道的重复插件 warning 的问题：Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may be overridden
因此，本文结合官方教程，整理了简洁的 OpenClaw 安装、绑定飞书机器人并按要求写飞书云文档的过程。
终端输入以下命令：
# 安装 Node
brew install node
# 检查版本
node -v && npm -v
# 安装 OpenClaw (使用时，网络问题需要自行解决)
npm install -g openclaw@latest
# PS: 卸载命令
npm uninstall -g openclaw
模型还没配置好，选第二个选项。
后续一系列选择：
Skill 可以现在配置，也可以后面再配。
注意：Channel 选择 Skip for now.
选择 Yes -> QuickStart。
终端输入：
# 初始化，之后都是空格选择，回车确认
openclaw onboard --install-daemon
目的：随时查看 OpenClaw 实际使用时产生的文件，例如配置文件 openclaw.json，agent 行为文件 memory.md，SOUL.md 等，方便知道其真实状态。
终端输入（将 替换为你的用户名）：
open -a Cursor --args /Users/<username>/.openclaw
重启网关：
openclaw gateway restart
浏览器打开 http://127.0.0.1:18789，在此处输入创建飞书应用时得到的 app id 和 app secret，点击 save。
然后，启动自带的飞书插件：
openclaw plugins enable feishu
重启 gateway：
openclaw gateway restart
选择本地模型或在线模型服务。
终端输入：
openclaw config
在命令框配对，即可。
首先，在飞书对应用随便发一条消息，得到回应。
openclaw pairing approve feishu <配对码>
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online