前言
OpenClaw 的安装教程虽多，但官方近期支持了飞书 Channel 后，部分复杂流程已不再必要。不过直接照搬官方步骤可能会遇到插件重复警告（如 duplicate plugin id detected）。本文结合实战经验，梳理了一套简洁的 OpenClaw 安装、飞书机器人绑定及云文档写入方案。
环境准备
首先确保本地已安装 Node.js。通过 Homebrew 安装较为便捷：
brew install node
安装完成后检查版本：
node -v
npm -v
接着全局安装 OpenClaw：
npm install -g openclaw@latest
# 如需卸载，执行 npm uninstall -g openclaw
*注意：国内网络环境下安装可能受阻，请自行配置代理或镜像源。
初始化配置
运行 onboard 命令开始初始化。由于我们主要关注飞书集成，模型和 Skill 均可后续补充，因此按以下逻辑操作：
- 模型未配置时，选择对应选项。
- Skill 配置项可选择 Skip。
- 关键点：Channel 环节务必选择
Skip for now。若此时强行配置飞书，会触发插件冲突，导致后续每次启动都出现警告。 - 确认 QuickStart 模式。
完成上述交互后，执行以下命令启动守护进程：
openclaw onboard --install-daemon
调试与文件查看
为了实时掌握 OpenClaw 的运行状态（如配置文件 openclaw.json、Agent 行为日志 memory.md 等），建议使用 Cursor 打开其工作目录：
open -a Cursor --args /Users/你的用户名/.openclaw
(请将路径中的用户名替换为实际用户) 这样可以在 IDE 中直观地观察底层文件的变更，排查问题会更高效。
飞书应用对接
这部分需要先在飞书开放平台完成基础建设：
- 创建应用并获取 App ID 和 App Secret。
- 配置应用权限及机器人能力。
- 配置事件订阅并发布应用。
回到本地，重启网关服务：
openclaw gateway restart
浏览器访问 http://127.0.0.1:18789，填入刚才获取的 App ID 和 App Secret 并保存。随后启用飞书插件：
openclaw plugins enable feishu
*提示：如果之前初始化时错误地添加了飞书 Channel，此处可能会报错，建议保持初始化时的'跳过'策略，仅在此处单独启用插件。
模型配置
对接前需指定使用的语言模型。重启网关后，在界面中选择 Local -> Model，根据需求配置（例如 Minimax 等）。 也可通过命令行调整配置：
openclaw config
配置完成后即可进入下一步验证。
配对与验证
在飞书对话框发送任意消息，等待系统回复配对码。随后在终端执行配对指令：
openclaw pairing approve feishu <配对码>
验证成功后，即可尝试通过飞书指令让 OpenClaw 撰写云文档。
