核心用法
本文档是针对 OpenClaw 连接飞书时的完整问题解决方案，涵盖三大核心场景：
1. 日历权限配置：提供标准化的 JSON 权限模板，确保日历读取、任务管理等功能正常运作。
2. 机器人消息交互：解决「机器人不回复消息」的完整权限清单，包含消息收发、文件操作、事件监听等 20+ 项权限配置。
3. 飞书平台配置：从启用机器人能力、配置 WebSocket 长连接、导入权限到发布应用的完整流程。
显著优点
- 即插即用：提供可直接导入的 JSON 权限配置，无需逐项勾选
- 问题驱动：按「症状→原因→解决」结构组织，快速定位问题
- 场景覆盖全：从基础配置到网络波动、时断时续等进阶问题均有涉及
- 命令行友好：包含完整的 CLI 操作流程，适合技术用户
潜在局限
- 时效性风险：飞书开放平台接口和权限项可能更新，JSON 配置需定期验证
- 企业审批依赖：飞书应用发布需管理员审批，流程耗时不可控
- 网络环境敏感：长连接对网络稳定性要求高，VPN/代理环境需特殊配置
- 生态绑定：深度依赖 OpenClaw 网关运行状态，非独立解决方案
适合人群
- 已部署 OpenClaw 但飞书连接失败的开发者
- 需要快速配置飞书机器人的技术运维人员
- 熟悉命令行操作、具备飞书开放平台账号权限的用户
常规风险
- 配置顺序敏感：长连接必须在网关启动后配置，否则验证失败
- 权限不足导致功能残缺：缺省关键权限时机器人表现异常但无明确报错
- 日志信息分散：问题排查需同时查看 OpenClaw 日志和飞书开放平台状态
- 安全风险：AppSecret 等凭证需妥善保管，避免泄露