飞书集成配置

概述

将OpenClaw机器人「清风」集成到飞书，让你在飞书中直接与AI助手对话。采用长连接模式，无需配置公网域名。

工作原理

飞书提供两种事件接收方式：

方式	说明	优点
Webhook回调	飞书主动发送HTTP请求到你的服务器	简单直接
长连接（推荐）	OpenClaw主动连接飞书，飞书通过长连接推送事件	无需公网IP/域名，防火墙友好

本教程使用长连接模式。

关键流程

在飞书创建应用「清风」
获取App ID和App Secret
在OpenClaw配置凭证
OpenClaw启动时自动连接飞书
飞书验证连接已建立
在飞书配置事件和权限
用户在飞书发消息→自动推送给OpenClaw

第1步：在飞书开放平台创建应用

1.1 创建应用

打开飞书开放平台
点击「创建企业自建应用」
应用名称：清风
应用描述：夏朝青的个人AI助手
点击「创建」

1.2 添加机器人能力

进入应用设置
左侧「应用能力」→ 添加「机器人」
配置完成

1.3 导入权限

左侧「权限管理」→ 「批量导入导出权限」
删除所有现有内容，复制以下权限JSON：

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "im:chat:read",
      "im:chat:readonly",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "im:message.group_msg"
    ],
    "user": [
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly"
    ]
  }
}

点击「下一步」→「确认新增权限」

第2步：获取应用凭证

重要提示 ⚠️

App ID 和 App Secret 是敏感信息，必须保密！

❌ 不要上传到GitHub或公开仓库
❌ 不要分享给不信任的人
❌ 不要在日志里打印完整值
✅ 使用环境变量或密钥管理系统存储
✅ 定期轮换Secret

2.1 复制凭证

进入应用「基本信息」页面
找到 App ID (格式：cli_xxxxx) - 记下此值
找到 App Secret (长字符串) - 记下此值

2.2 在OpenClaw中配置凭证

在服务器执行以下命令（替换实际的App ID和Secret）：

ssh openclaw "openclaw config set channels.feishu.appId 'cli_xxxxx'"
ssh openclaw "openclaw config set channels.feishu.appSecret 'your_secret_here'"
ssh openclaw "openclaw config set channels.feishu.enabled true"

配置后，重启Gateway：

ssh openclaw "systemctl restart openclaw-gateway"

OpenClaw启动时会自动使用这个凭证连接飞书。

第3步：飞书验证连接

当OpenClaw配置好凭证并重启后：

OpenClaw读取App ID和Secret
OpenClaw主动连接飞书WebSocket服务器
建立长连接（保持打开）
飞书记录：「这个应用已连接」

这时，你在飞书配置事件才能成功。

第4步：在飞书配置事件

4.1 进入事件配置

在飞书开放平台，左侧 → 事件与回调
点击「添加事件」

4.2 添加4个事件

分别搜索并添加以下4个事件：

事件代码	说明	必须
`im.message.receive_v1`	接收消息	✅
`im.chat.member.bot.added_v1`	机器人被添加到群组	✅
`im.message.bot_muted_v1`	机器人被禁言	✅
`im.message.message_read_v1`	消息已读	✅

为什么这时能保存成功？因为OpenClaw已经用你的App ID和Secret连接到飞书了，飞书检查发现连接已建立，所以允许配置事件。

第5步：创建版本并发布

左侧 → 版本管理与发布
输入版本号（如：1.0.0）
输入更新说明（如：「首次发布清风机器人」）
点击「保存」
右上角点击「确认发布」

第6步：设备配对

6.1 第一次对话

在飞书中搜索或进入「清风」机器人
发送任意消息（如："你好" 或 "hi"）
收到配对提示，包含配对码（如：D22ND67F）

6.2 批准配对

在服务器执行：

ssh openclaw "openclaw pairing approve feishu D22ND67F"

（替换 D22ND67F 为实际的配对码）

配对成功后，以后就可以直接在飞书与清风对话了。

第7步：允许多人使用（可选）

如果只是个人使用，可以跳过。如果要让团队使用，执行：

ssh openclaw "openclaw config set channels.feishu.auth.mode open"
ssh openclaw "openclaw config set channels.feishu.dmPolicy open"
ssh openclaw "openclaw config set channels.feishu.allowFrom '[\"*\"]' --json"

配置完成！

现在你可以在飞书中与「清风」AI助手对话了！

✨ 快速回答问题
✨ 信息整理和总结
✨ 内容生成和优化
✨ 提升工作效率

安全建议

定期轮换App Secret
监控API调用日志
限制使用者范围
不要在代码注释中暴露凭证
使用加密存储敏感信息