💬 飞书接入
👤 适合谁：使用飞书/Lark 办公的企业用户
⏱️ 阅读时长：约 6 分钟
💡 一句话：让 YingClaw 融入你的飞书工作流，智能助手触手可及。
将 YingClaw 接入飞书（兼容 Lark），支持 WebSocket（长连接）和 Webhook（回调）两种接收模式，灵活适配不同网络环境。
接入概览
YingClaw 提供两种飞书接入方式：
- WebSocket 模式：长连接实时推送，无需公网 IP（推荐）
- Webhook 模式：传统 HTTP 回调，适合有公网 IP 的环境
| 场景 | 说明 |
|---|---|
| 💼 企业协作 | 飞书群聊中 @ Bot 获取帮助 |
| 📋 审批通知 | 审批状态变更自动通知 |
| 📢 消息推送 | 定时任务结果推送到飞书 |
配置步骤
1. 获取飞书应用凭证
前往 飞书开放平台 创建企业自建应用，获取：
- App ID：应用唯一标识
- App Secret：应用密钥
2. 在 YingClaw 中配置
登录 YingClaw Web 控制台，进入「通信频道」页面，打开飞书开关：
| 参数 | 说明 |
|---|---|
app_id | 飞书开放平台分配的 App ID |
app_secret | 飞书开放平台分配的 App Secret |
encrypt_key | 消息加密密钥（可选） |
verification_token | 事件验证 Token（可选） |
receive_mode | 接收模式：websocket（推荐）或 webhook |
port | Webhook 模式下的监听端口，默认 9898 |
allowed_users | 允许使用 Bot 的用户白名单，* 表示所有用户 |
3. 选择接收模式
WebSocket 模式（推荐）：
- 无需公网 IP 和回调地址
- 实时推送，延迟低
- 适合大多数部署环境
Webhook 模式：
- 需要配置公网回调地址
- 适合已有公网 IP 的服务端部署
- 需要手动配置端口号
4. 启动通道
保存配置后，YingClaw 自动建立连接并开始接收消息。
消息交互
私聊场景
员工直接向飞书 Bot 发送消息，YingClaw 实时响应，支持：
- 💬 智能对话和知识问答
- 📊 数据分析和可视化
- 📝 文档协作和编辑
- ⏰ 日程和任务管理
群聊场景
将 Bot 添加到飞书群后，@ Bot 即可触发响应。YingClaw 会根据不同区域（中文/英文/日文）自动适配回复语言。
白名单控制
channels:
feishu:
allowed_users:
- "user_abc123" # 仅允许特定用户
# - "*" # 允许所有用户
注意事项
- WebSocket 模式推荐用于大多数部署，无需公网 IP
- Webhook 模式需要确保防火墙开放对应端口
- 加密密钥和验证 Token 为可选配置，用于增强安全性