OpenClaw 完全指南（03）：飞书集成——打造团队 AI 助手

OpenClaw 完全指南（03）：飞书集成------打造团队 AI 助手

为什么选择飞书集成？

飞书是字节跳动出品的企业协作工具，在中国企业和 AI 社区中广泛使用。与飞书集成意味着：

💼 团队协作：在飞书群聊中 @AI 助手
📊 工作流自动化：日程、任务、文档等集成
🔐 权限管理：完整的企业安全性
🌐 多语言：原生中文支持

OpenClaw + Feishu 架构

复制代码

┌─────────────────────────────────┐
│     Feishu 企业工作区           │
│  ┌─ 私聊 + AI Chatbot           │
│  ├─ 群聊 + @AI 提及             │
│  └─ 日程 + 任务同步             │
└────────────┬────────────────────┘
             │
      WebSocket 长连接
             │
┌────────────▼────────────────────┐
│   OpenClaw Gateway              │
│  (本地消息处理中心)             │
└────────────┬────────────────────┘
             │
┌────────────▼────────────────────┐
│       Agent (AI 大脑)           │
│  (可访问飞书日历、任务等)        │
└─────────────────────────────────┘

集成步骤（10 分钟）

第 1 步：创建飞书应用

登录飞书管理后台
创建新应用 → 选择"自建应用"
填写应用基本信息：
- 应用名称：My OpenClaw Bot
- 应用描述：私人 AI 助手
保存应用 ID 和 Secret

第 2 步：配置事件订阅

在飞书管理后台：

进入"事件与回调"
启用 WebSocket
请求地址：http://your-ip:18789/webhook/feishu
订阅事件：
- im.message.receive_v1（接收消息）
- im.message.message_read_v1（消息已读）

第 3 步：配置 OpenClaw

json 复制代码

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "YOUR_APP_ID",
      "appSecret": "YOUR_APP_SECRET",
      "webhookUrl": "http://your-ip:18789/webhook/feishu",
      "connect": {
        "protocol": "websocket"
      }
    }
  }
}

或者用命令：

bash 复制代码

openclaw channel add feishu \
  --appId YOUR_APP_ID \
  --appSecret YOUR_APP_SECRET

第 4 步：设置 Bot 功能

在飞书应用页面，启用：

✅ 机器人能力（Bot Ability）
✅ 获取单聊历史消息
✅ 获取群聊历史消息
✅ 查看用户信息

第 5 步：发布应用

提交审核
等待飞书官方审核（通常 1-2 小时）
审核通过后激活

使用场景

场景 1：私聊助手

在飞书私聊中与 AI 对话：

复制代码

你：总结一下今天的会议
AI：根据你的日历，今天有 3 个会议：
  1. 产品讨论（10-11 AM）
  2. 技术评审（2-3 PM）
  3. 团队站会（4 PM）
要查看某个会议的详情吗？

场景 2：群聊助手

在团队群中 @AI 处理问题：

复制代码

@AI 帮我检查一下今天的任务优先级
@AI 根据下个月的日程，建议开会时间
@AI 翻译这段英文文档

场景 3：自动化工作流

javascript 复制代码

// 当有新任务时自动提醒
if (event.type === 'task_created') {
  await bot.notify(
    `新任务：${event.title}\n` +
    `负责人：${event.owner}\n` +
    `截止：${event.dueDate}`
  );
}

常见问题

Q: 飞书 Bot 能访问我的私密信息吗？

A: 不能。OpenClaw 只能访问你明确授予的权限。这由飞书的权限系统管理。

Q: 支持文件上传吗？

A: 完全支持。你可以在飞书群聊中上传文件给 AI 处理（文档识别、代码审查等）。

Q: 可以与飞书日历同步吗？

A: 可以。启用"获取日历"权限后，AI 可以查看和修改你的日程。

Q: 群聊中的其他成员能看到我与 AI 的对话吗？

A: 不能。私聊内容完全私密。群聊中只有 @AI 的消息会被处理。

安全性建议

✅ 启用这些：

使用 WSS（加密 WebSocket）
启用 IP 白名单
定期更换 Secret

❌ 避免这些：

不要在群聊中分享敏感数据
不要给 Bot 过高权限
不要在公开场景存储密钥

下一步

现在你已经：

✅ 理解了飞书架构
✅ 学会了基本集成
✅ 知道了使用场景

后续学习：

高级权限配置
工作流自动化
多 Agent 路由
Skill 开发

发布时间 ：2026-03-11
难度：⭐⭐⭐ 中级
前置知识：OpenClaw 基础、飞书账户