用 OpenClaw 打造飞书智能助手：定时任务 + 数据收集 + 文档表格自动化

很多人用飞书，但从来没想过让它变得更聪明。

今天介绍一个开源工具 OpenClaw，配合飞书企业自建应用，可以实现：

• 📅 定时任务：比如每天早上 9 点自动推送日报模板到群
• 📊 收集数据：自动收集群成员填写的表单数据，整理成表格
• 📁 文档/表格自动化：根据对话内容自动生成文档、表格，发送到飞书云文档

整个配置不需要写代码，零基础也能搞定。

一、什么是 OpenClaw？

OpenClaw 是一个 AI 助手框架，支持接入多种消息渠道（飞书、Discord、钉钉、Telegram 等），通过自然语言对话来完成任务。

核心能力：

• 多渠道接入（飞书是其中之一）
• 插件式工具扩展（定时任务、文件操作、数据收集等）
• 支持私有化部署，数据自己掌控

GitHub：^[1]https://github.com/openclaw/openclaw^[2]

二、接入飞书前的准备

2.1 环境要求

• OpenClaw 版本 ≥ 2026.4.25
• 一个飞书企业账号（需要管理员权限）
• 公网 IP（飞书机器人需要接收 Webhook 事件）

2.2 核心概念先理解

接入飞书主要涉及两个概念：

机器人（Bot）：在飞书里和你对话的 AI 助手。

事件订阅：飞书把用户消息转发给 OpenClaw 的方式。有两种模式：

• WebSocket 模式（推荐）：OpenClaw 主动和飞书保持连接，实时接收消息，配置更简单。
• Webhook 模式：需要暴露公网端口给飞书回调，配置相对麻烦。

本文以 WebSocket 模式为准。

三、Step by Step：5 步完成飞书接入

第一步：创建飞书自建应用

1. 打开 飞书开放平台^[3]，点击「创建应用」
2. 选择「企业自建应用」，填写应用名称和描述
3. 进入应用后，左侧菜单找「凭证与基础信息」，复制 App ID 和 App Secret（稍后会用到）

第二步：配置权限

1. 在「权限管理」中，添加以下权限（按需添加，这里是常用权限集）：

1. 发布应用（点击左侧「版本管理与发布」）

第三步：配置事件订阅

1. 在「事件订阅」页面，选择 使用长连接接收事件（这步很关键！）
2. 订阅以下两个事件： 
• im.message.receive_v1（接收消息）
• im.message.message_read_v1（消息已读，可选）

第四步：在 OpenClaw 里配置飞书渠道

运行向导命令：

openclaw channels login --channel feishu

扫码登录后，OpenClaw 会自动写入配置到 gateway.json，格式大致如下：

{"channels":{"feishu":{"enabled":true,"connectionMode":"websocket","accounts":{"default":{"appId":"cli_xxxxxxxx","appSecret":"xxxxxxxxxxxxxxxx"}}}}}

如果需要手动配置，参考官方文档：^[4]https://docs.openclaw.ai/channels/feishu^[5]

第五步：重启 Gateway 使配置生效

openclaw gateway restart

重启完成后，给机器人发一条消息测试一下。如果正常回复，说明接入成功 🎉

四、飞书机器人的高级玩法

接入了飞书只是开始，真正有价值的是用它来做自动化。

玩法 1：定时推送任务

利用 OpenClaw 的 Cron 功能，可以定时执行任务并推送到飞书群。

比如每天早上 9 点自动在群里发一条工作安排提醒：

// 在 OpenClaw 中创建一个 Cron Job{"name": "daily-reminder","schedule": {"kind": "cron","expr": "0 9 * * *","tz": "Asia/Shanghai"  },"payload": {"kind": "systemEvent","text": "📋 今日工作安排提醒：请各组负责人更新项目进度"  },"delivery": {"mode": "announce","channel": "feishu","to": "oc_xxxxxxxx群ID"  }}

玩法 2：数据收集 + 自动整理成表格

当有人在群里提交数据（比如周报、数字统计），机器人可以识别消息内容，自动写入飞书表格。

流程：

1. 群里有人发格式化的数据（如「项目A：完成度80%」）
2. OpenClaw 解析消息内容
3. 调用飞书 Sheet API，把数据写入指定表格

// 示例：解析并写入表格的逻辑伪代码const message = "项目A：80% | 项目B：60% | 项目C：90%";const rows = message.split("|").map(item => {const [name, progress] = item.split("：");return [name.trim(), progress.trim()];});// 调用飞书表格 API 写入 rows

玩法 3：对话生成飞书文档

直接告诉 OpenClaw：「帮我把这个会议记录整理成飞书云文档」，机器人会自动调用飞书文档 API，生成结构化文档。

支持的文档类型：

• 📝 云文档（docx）
• 📊 表格（sheet）
• 📅 日历事件

五、常见问题

Q1：机器人没有响应

排查顺序：

1. 机器人是否已经发布（检查版本管理）？
2. 事件订阅是否选择了「长连接」模式？
3. 权限是否都申请了？
4. 群里是否 @ 了机器人？

执行 openclaw logs --follow 查看实时日志，定位问题。

Q2：IP 不在白名单

飞书开放平台要求调用者的 IP 在白名单里。如果是本地开发调试，需要使用内网穿透工具（如 frp、ngrok）把 OpenClaw 服务暴露到公网，并将该公网 IP 加入白名单。

Q3：多账号支持

如果需要在同一个 OpenClaw 实例里管理多个飞书机器人，参考官方文档的 accounts 配置：

{"channels":{"feishu":{"defaultAccount":"main","accounts":{"main":{"appId":"cli_主应用","appSecret":"xxx"},"backup":{"appId":"cli_备用应用","appSecret":"yyy","enabled":false}}}}}

六、总结

OpenClaw + 飞书这套组合，真正有价值的地方在于：

• 私有化：数据都在你自己的服务器上，不会经过第三方
• 可扩展：通过 Skills 机制，可以接入更多工具（邮箱、日历、GitHub 等）
• 自动化：把重复性工作交给 AI，释放人力

零基础也能配置，推荐先从「定时推送消息」这个简单玩法入手，找到感觉后再探索数据收集、文档生成这些进阶功能。

官方文档非常详细，有问题可以直接翻文档：^[6]https://docs.openclaw.ai^[7]

如果觉得有用，欢迎转发。

引用链接