前言
OpenClaw 的安装教程虽然不少，但最近官方支持了飞书 Channel，让一些过于复杂的步骤变得不再必要。不过直接照搬官方教程也可能遇到社区反馈的重复插件警告问题（例如 Config warnings: plugins.entries.feishu: plugin feishu: duplicate plugin id detected）。
本文将结合官方文档与实战经验，梳理一套简洁的 OpenClaw 安装流程，重点解决绑定飞书机器人及编写飞书云文档的配置细节。
1. 环境准备：安装 Node 和 OpenClaw
首先确保本地已安装 Node.js。在终端执行以下命令检查版本并安装 OpenClaw。
# 安装 Node.js (macOS)
brew install node
# 检查版本
node -v
npm -v
# 安装 OpenClaw (全局安装)
npm install -g openclaw@latest
# 卸载命令参考
npm uninstall -g openclaw
注意： 安装过程中若遇到网络超时，请自行配置代理或切换镜像源。OpenClaw 对网络环境有一定要求，调成 tune 模型时尤为明显。
2. 初始化配置
运行初始化命令后，系统会引导进行一系列选择。由于我们稍后会手动配置飞书插件，建议在此阶段跳过 Channel 配置，避免后续出现插件冲突。
openclaw onboard --install-daemon
关键步骤说明：
- 模型配置：如果尚未配置好模型，可选择第二项进行设置。
- Skill 配置：可以现在配置，也可以留到后面再配。
- Channel 选择：务必选择
Skip for now（暂时跳过），这是避免重复插件警告的关键。 - 快速开始：选择
Yes->QuickStart。
执行完成后，终端应显示初始化成功的提示。
3. 查看底层文件结构（可选）
为了方便调试，我们可以随时查看 OpenClaw 实际运行时产生的文件，如配置文件 openclaw.json、Agent 行为文件 memory.md 等。
使用 Cursor 打开 OpenClaw 的工作目录：
open -a Cursor --args /Users/xxx/.openclaw
(请将 /Users/xxx 替换为实际路径)
4. 飞书应用配对
这一步需要先在飞书开放平台完成应用创建，然后对接 OpenClaw。
第一步：创建飞书应用
访问 OpenClaw 飞书官方文档，完成以下步骤：
- 打开飞书开放平台。
- 创建企业自建应用。
- 获取应用凭证（App ID 和 App Secret）。
- 配置应用权限。
- 启用机器人能力。
- 配置事件订阅。
- 发布应用。
第二步：配置网关与插件
重启网关服务：
openclaw gateway restart
