OpenClaw 接入飞书：从安装到插件生态的一次实践

最近 OpenClaw（之前叫 ClawdBot / Moltbot）热度很高。AI 迭代太快，不去折腾一下总觉得会被甩在后面。这篇记录我自己从“本地部署”到“接入飞书”的完整过程，写完才回头整理，细节可能有出入，欢迎指正。

先声明：OpenClaw 需要访问不少本地权限和文件。建议找一台“可控、可丢”的机器来试水，避免隐私数据泄露。我用的是 2017 款的 MacBook Pro（准备回收的那台），正好拿来做实验。

0. 环境准备

我的环境是 macOS，其他平台步骤大同小异。

Node 版本要求：Node ≥ 22
我用的是 nvm 管理版本，方便切换

Node 版本

1. 安装 OpenClaw

1.1 全局安装 + 后台服务

# 推荐全局安装
npm install -g openclaw@latest
# 启动并安装后台服务
openclaw onboard --install-daemon

安装过程

1.2 风险提示确认

安装过程中会有风险提示，选择 Yes 即可。

风险提示

2. 快速设置与模型选择

进入快速设置后，会让你选择模型。我这边选了 智谱 GLM，主要是觉得本地和国内网络更顺手一些。（你也可以选 Qwen、OpenCode 等）

模型选择

后面根据提示在智谱平台注册并获取 API Key：

API Key 获取

3. Channel 选择（飞书先跳过）

快速设置阶段默认提供的是海外渠道（比如 Slack 等）。飞书需要后面自己手动配置，所以先跳过：

Channel 跳过

4. Skills 与 Hooks 插件

4.1 Skills

按需添加即可，我就走一遍流程：

Skills 安装

4.2 Hooks（强烈建议全选）

我看了下三个 hook 的作用：

boot-md：启动时加载 markdown 引导文档（规则、偏好、项目背景）
command-logger：记录 OpenClaw 执行的命令
session-memory：会话记忆（对模型短上下文特别关键）

所以我建议直接全选。

Hooks 选择

安装完成后会自动启动 UI，大致会看到这个界面：

OpenClaw UI

5. 接入飞书

我参考了这个开源项目： https://github.com/m1heng/Clawdbot-feishu

5.1 安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

5.2 创建飞书应用

进入飞书开放平台： https://open.feishu.cn/

创建应用后拿到 App ID 和 App Secret：

创建应用

5.3 配置 OpenClaw

先把飞书信息配置进 OpenClaw：

openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw config set channels.feishu.enabled true

配置 App 信息

5.4 能力与权限

先开启机器人的基础能力，否则后续权限看不到：

能力配置

权限方面，我把必需权限全开：

权限配置

必需权限（建议全部开启）：

权限	说明
`contact:user.base:readonly`	获取用户基本信息，避免同名混淆
`im:message`	发送和接收消息
`im:message.p2p_msg:readonly`	读取私聊消息
`im:message.group_at_msg:readonly`	接收群内 @ 消息
`im:message:send_as_bot`	机器人身份发送消息
`im:resource`	上传/下载图片和文件

可选权限（看需求开）：

权限	说明
`im:message.group_msg`	读取群消息（敏感）
`im:message:readonly`	获取历史消息
`im:message:update`	编辑已发送消息
`im:message:recall`	撤回消息
`im:message.reactions:read`	读取消息表情

5.5 事件订阅（最容易漏）

如果机器人能发消息但收不到消息，大概率就是这里忘了配置。

进入飞书开放平台的 事件与回调 页面：

事件与回调

配置建议：

事件配置方式：选择 使用长连接接收事件（推荐）
添加事件订阅，勾选这些事件：

事件订阅

事件	说明
`im.message.receive_v1`	接收消息（必需）
`im.message.message_read_v1`	消息已读回执
`im.chat.member.bot.added_v1`	机器人进群
`im.chat.member.bot.deleted_v1`	机器人被移出群