核心用法
本技能文档为 OpenClaw 平台连接飞书 的技术配置指南，主要解决三类典型问题：
1. 机器人不回复 — 提供完整的租户级与用户级 OAuth 权限清单（JSON 格式），一键导入即可修复消息收发、成员读取、菜单写入等核心能力缺失问题。
2. 应用平台检查 — 四步标准化流程：
- 启用「机器人能力」并命名
- 关键步骤：在 OpenClaw 网关启动后，配置「长连接」事件订阅，添加
im.message.receive_v1事件 - 权限管理批量导入 JSON
- 版本创建与发布
3. 日历权限开放 — 额外提供日历读写、任务管理的双层级（tenant/user）权限模板，支持日程与任务场景的扩展集成。
显著优点
- 开箱即用：所有权限以可直接粘贴的 JSON 块呈现，零手工拼写错误
- 顺序敏感：明确标注「网关启动后再配长连接」的时序依赖，避免反复调试
- 场景覆盖：不仅解决基础消息，还包含日历、任务等进阶权限
潜在局限
- 平台绑定：仅针对飞书（Feishu/Lark）生态，企业微信、钉钉等其他 IM 需另找文档
- 版本依赖：未注明 OpenClaw 与飞书 API 的具体版本兼容性，升级后可能需要重新核对权限列表
- 网络前提：长连接模式要求 OpenClash 网关可公网访问或内网穿透，文档未涉及网络层故障排查
适合人群
- 使用 OpenClaw 自建飞书机器人的开发者 / 运维人员
- 企业 IT 管理员需快速排查机器人无响应、权限不足等问题
- 需要集成飞书日历、任务能力的进阶用户
常规风险
- 权限过度授权：JSON 中
tenant级权限范围较宽，若应用被恶意利用，可能导致企业通讯录、全量消息泄露；建议按最小权限原则复核 - 长连接断线：网关重启或网络波动会导致事件丢失，生产环境建议配置监控与自动重连
- 版本发布延迟：飞书应用审核或企业管理员审批可能造成配置生效时间不可控