（2232期）Lark Toolkit – 飞书 Lark 全栈 API 开发指南

飞书 Lark 全栈 API 开发指南 飞书/Lark 官方 API 文档级工具集，支持消息收发、日程管理、通讯录查询等 38+ MCP 操作及直接 API 调用，需用户自配凭证。 使用说明 Lark Toolkit 综合评估 核心用法 Lark Toolkit 是面向 OpenClaw 智能体的飞书/Lark 生态全功能接口指南，采用三层访问架构：claw-lark 插件处理基础消息收发，MCP 工具（mcporter）覆盖 Bitable、日历、文档、任务、OKR 等 38 个结构化操作，直接 API（curl）填补通讯录部门查询、群组成员管理、消息表情反应等 MCP 未覆盖场景。所有路径均需用户提供 appid 与 appsecret，通过 tenantaccesstoken 认证，支持国际版（open.larksuite.com）与国内飞书（open.feishu.cn）双平台。 显著优点 分层设计合理：三层路径形成清晰的能力梯度，从简单消息到复杂 CRUD 均有对应方案，降低学习成本 零硬编码安全：凭证完全外置，支持环境变量、命令行参数及 OpenClaw 标准配置文件（~/.openclaw/openclaw.json）三种注入方式，脚本仅读取不缓存 覆盖场景全面：既包含 38 个 MCP 工具的标准化调用，又提供直接 API 的完整 curl 示例，解决通讯录查询、Webhook 调试等边缘需求 pitfalls 文档详尽：明确标注 Lark≠Feishu 域名差异、open_id 的 per-app 隔离性、Webhook 5 秒超时、事件去重等 8 个关键陷阱，减少生产踩坑 潜在局限 文档而非可执行代码：本 skill 仅为参考指南，不含自动凭证获取或请求封装逻辑，用户需自行拼接 curl 或配置 mcporter Token 生命周期管理：tenantaccesstoken 约 2 小时过期，需自行缓存刷新逻辑，文档未提供自动续期方案 MCP 与 API 能力断层：部门用户列表、表情反应、文件上传等高频操作仍依赖直接 API，增加调用复杂度 双平台差异化未抽象：国际版与国内版域名、权限体系存在差异，用户需自行确认租户所属平台 适合人群 企业自动化开发者：需通过 OpenClaw 智能体对接飞书/Lark 办公流的工程师 DevOps/运维团队：需批量查询通讯录、管理群组、监控机器人状态的运维人员 低代码集成者：通过 MCP 工具快速搭建日历、任务、OKR 工作流的用户 常规风险 凭证泄露风险：若将 app_secret 写入 shell 历史或日志，可能导致租户级权限泄露；建议优先使用环境变量或专用凭证文件 平台混淆风险：错误选择 Lark/飞书域名会导致 API 404 或权限异常，需与租户管理员确认平台归属 Webhook 超时与重试：业务处理超时需异步化，否则 Lark retries 可能引发副作用；需实现 event_id 幂等去重 原始说明 Comprehensive Lark/Feishu API skill for OpenClaw agents. Covers all Lark operations via three access paths: claw-lark plugin (message tool), MCP tools (mcpor...