前言
飞书是国内企业广泛使用的协作平台。OpenClaw 原生支持飞书频道对接，采用 WebSocket 长连接模式，无需公网服务器即可完成部署。本教程将带你从零完成飞书机器人的创建和配置。
前置要求
- 已安装并运行 OpenClaw
- 飞书企业账号（或个人开发者账号）
- 飞书开放平台访问权限
第一步：创建飞书应用
1. 访问飞书开放平台
登录 飞书开放平台，进入开发者后台，点击创建企业自建应用。
填写应用信息：
- 应用名称：如"OpenClaw 助手"
- 应用描述：简要说明用途
2. 获取应用凭证
在应用的凭证与基础信息页面，复制：
- App ID：应用唯一标识
- App Secret：应用密钥
# 记录这两个值，后续配置需要
App ID: cli_xxxxxxxxxxxxxxxxx
App Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
第二步：配置应用权限
批量导入权限（推荐）
飞书支持通过 JSON 批量导入权限，省去逐个勾选的麻烦。在应用的权限管理页面，使用批量开通功能导入以下权限：
{
"scopes": [
"im:message",
"im:message:send_as_bot",
"im:message.group_at_msg",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg",
"im:message.p2p_msg:readonly",
"im:resource"
]
}
手动添加权限
如果批量导入不可用，手动在权限管理页面中依次勾选：
im:message- 获取与发送单聊、群组消息im:message:send_as_bot- 以应用的身份发送消息im:resource- 获取与上传图片或文件资源
第三步：启用机器人能力
- 在应用配置中进入添加应用能力
- 选择机器人，点击添加
- 进入机器人配置页面，确认机器人功能已启用
第四步：订阅事件
进入事件订阅页面：
- 选择连接方式为 WebSocket（长连接模式）
- 添加事件：
im.message.receive_v1（接收消息事件）
WebSocket 模式的优势：
- 无需公网 IP 或域名
- 无需配置回调 URL
- 连接稳定，自动重连
第五步：配置 OpenClaw
交互式配置（推荐）
使用 OpenClaw 内置的交互式添加命令：
openclaw channels add
按提示选择 feishu 类型，依次输入 App ID 和 App Secret 即可完成配置。
手动配置
在 OpenClaw 配置文件中添加飞书频道：
channels:
- type: feishu
appId: "cli_xxxxxxxxxxxxxxxxx"
appSecret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
dmPolicy: "open"
groupPolicy: "onmention"
requireMention: true
streaming: true
replyToMode: "first"
核心配置详解
私聊策略（dmPolicy）
dmPolicy: "open" # 接受所有私聊消息
dmPolicy: "paired" # 需要管理员审批
dmPolicy: "off" # 关闭私聊功能
群组策略（groupPolicy）
groupPolicy: "off" # 不响应群组消息
groupPolicy: "onmention" # 被 @ 时响应（推荐）
groupPolicy: "all" # 响应所有群组消息
流式回复（streaming）
开启后 AI 的回复会逐步显示，而不是等全部生成后一次性发送，提升用户体验：
streaming: true
提及要求（requireMention）
在群组中是否需要 @ 机器人才触发回复：
requireMention: true # 推荐在群组场景下开启
回复模式（replyToMode）
控制在消息话题中的回复行为：
| 模式 | 说明 |
|---|---|
off |
不以回复形式发送 |
first |
回复话题中的第一条消息 |
all |
回复每条消息 |
消息处理特性
文本分块
飞书单条消息长度限制为 2000 字符。当 AI 回复超过此限制时，OpenClaw 会自动拆分为多条消息发送。
媒体文件
支持收发图片、文件等媒体内容，单个文件大小限制为 30MB。
发布应用
完成配置后，在飞书开放平台提交应用审核：
- 进入版本管理与发布
- 创建新版本
- 填写更新说明
- 提交审核（企业内部应用通常可以快速通过）
审核通过后，企业成员即可在飞书中搜索并使用机器人。
常见问题
机器人没有响应消息
- 确认应用已发布且处于启用状态
- 检查事件订阅是否正确配置了
im.message.receive_v1 - 确认 WebSocket 连接方式已选择
- 查看 OpenClaw 日志中是否有飞书相关错误
群组中 @ 机器人无反应
确认机器人已被添加到群组中，且拥有 im:message.group_at_msg:readonly 权限。
权限不足
重新检查权限列表是否完整，修改权限后需要重新发布应用版本才会生效。
总结
飞书的 WebSocket 长连接模式让对接过程非常简单，不需要公网服务器即可完成部署。配合流式回复和群组 @ 触发，能为飞书用户提供流畅的 AI 助手体验。