# OpenClaw 飞书插件完整开通指南
## 一、什么是 OpenClaw？
OpenClaw 是一款开源的个人 AI Agent 系统，可以运行在个人电脑或服务器上。它是完全属于你的私人助理，拥有长期记忆，能力持续进化，拥有更高的权限，能直接操作电脑，本地运行、还能 24 小时主动干活。
## 二、OpenClaw 飞书官方插件能力
### 2.1 核心特点
- **数字分身**：以你的身份完成工作（发消息，写文档、创建表格等）
- **全面上下文**：获取飞书内的海量信息（消息、文档，会议纪要，多维表格，日程、任务等）
- **流式输出**：支持消息卡片流式生成，实时展示思考过程
### 2.2 完整能力一览
| 类别 | 能力 |
|------|------|
| 消息 | 消息读取（群聊/单聊历史、话题回复）、消息发送、消息回复、消息搜索，图片/文件下载 |
| 文档 | 创建云文档、更新云文档、读取云文档内容 |
| 多维表格 | 创建/管理多维表格，数据表、字段、记录（增删改查、批量操作、高级筛选）、视图 |
| 日历日程 | 日程管理（创建/查询/修改/删除/搜索）、参会人管理、忙闲查询 |
| ✅ 任务 | 任务管理（创建/查询/更新/完成）、清单管理，子任务、评论 |
## 三、插件安装步骤
### 3.1 安装 OpenClaw
**Linux/MacOS：**
curl -fsSL https://openclaw.ai/install.sh | bash
**Windows：**
iwr -useb https://openclaw.ai/install.ps1 | iex
### 3.2 安装飞书插件
执行指令：
openclaw plugin install lark
或在配置文件 ~/.openclaw/config.yaml 中添加：
plugins:
- name: lark
config:
app_id: cli_xxxxx
app_secret: xxxxx
### 3.3 配置飞书应用权限
在飞书开放平台需要开通以下权限：
- im:message - 消息读取权限
- im:message.send_as_user - 以用户身份发消息
- im:chat - 群聊管理
- im:contact - 通讯录权限
- calendar:calendar - 日历权限
- drive:drive - 云空间权限
- wiki:wiki - 知识库权限
- bitable:bitable - 多维表格权限
- task:task - 任务权限
### 3.4 飞书扫码授权
首次使用需要扫描飞书二维码进行授权绑定，授权完成后即可开始使用。
## 四、开启流式卡片与状态展示
### 4.1 开启流式卡片
在对话中输入：
/reasoning stream
可选模式：
- on - 开启思考但不流式输出
- off - 关闭思考
- stream - 开启思考并流式输出（推荐）
### 4.2 效果说明
开启后将显示：
- 思考过程实时流式输出
- ⏱️ 任务耗时统计
- 执行状态展示
## 五、定时任务管理
### 5.1 查看定时任务
发送消息「查看我的定时任务」，系统将返回所有定时任务列表。
### 5.2 状态说明
- ✅ 正常：任务正常运行
- ⚠️ 错误：任务执行失败，需检查配置
- ⏸️ 已暂停：任务被手动关闭
### 5.3 管理命令
- 关闭任务：「关闭XXX提醒」
- 查看详情：可查看任务配置，执行日志、错误信息
## 六、内容发布到美泡泡网站
### 6.1 发布流程
1. **生成内容**：告诉 AI 你需要发布的内容主题
2. **预览确认**：AI 会先将内容发送给你预览
3. **确认发布**：你确认无误后，AI 帮你发布到美泡泡
### 6.2 示例对话
你：帮我发一篇科技新闻到美泡泡
AI：[生成内容后] 这是预览内容，确认发布吗？
你：确认
AI：已发布到美泡泡网站
### 6.3 支持的内容类型
- 新闻简报
- 文章推送
- 数据报告
- 活动通知
## 七、安全与注意事项
### 7.1 核心风险
⚠️ 这个插件通过飞书接口连接了你的工作数据——消息、文档，日历、联系人，AI 能读到的东西理论上就有泄露的可能。
### 7.2 使用建议
1. **先预览再确认**：重要操作（发送、修改、写入）一定要预览确认
2. **个人账号先行**：建议先用个人账号玩熟再用工作账号
3. **定期检查**：定期查看定时任务状态，确保正常运行
4. **注意隐私**：避免让 AI 处理敏感信息
### 7.3 常见问题
**Q1: 流式卡片不显示？**
A: 检查是否开启了 reasoning 模式，输入 /reasoning stream
**Q2: 定时任务失败怎么办？**
A: 查看错误信息，常见问题包括 API 配置不完整、权限不足等
**Q3: 插件安装失败？**
A: 检查 OpenClaw 是否正确安装，确保网络畅通