OpenClaw 飞书能力实战：踩坑、绕路、最终打通云文档/日历/任务

Wed, 27 May 2026 11:08:00 +0800

为什么选飞书链接到标题

OpenClaw 接入 IM 的几种方式里，飞书是目前最好的选择。Telegram、Discord 都是国外平台，国内访问不稳定；微信个人号方案有封号风险。飞书拥有开放的 API 生态、免公网 IP 的长连接方式，以及云文档、多维表格、日历、任务等一体化工作能力，天然适合作为 AI Agent 的操作界面。

踩坑：飞书官方插件链接到标题

飞书官方推出了 OpenClaw 插件 @larksuite/openclaw-lark，号称可以让 Agent 以用户身份操作飞书资源：创建文档、管理任务、查看日历等。我按照官方文档在服务器上安装并启用后，对话正常，Agent 也能回复消息。

但问题来了——让 Agent 创建一个飞书任务，它回复"已创建"；让创建云文档，也说"已创建"。然而打开飞书，任务列表里空空如也，云文档里也没有任何新文件。

查日志发现了关键错误：

[plugins] plugin must declare contracts.tools before registering agent tools

追到 OpenClaw 主仓库，发现这是 OpenClaw 核心框架的一个 bug（issue #80621）：插件明明正确声明了 contracts.tools: true，但运行时在注册工具时被拒绝。修复补丁（PR #84512）已提交，但尚未合入。

所以 openclaw-lark 本身没有 bug，是上游 OpenClaw 框架的 registerTool 检查逻辑有问题，导致飞书官方插件的所有工具（任务、文档、日历等）都无法注册到 Agent。Agent 回退到用 message 工具发送文本消息，所以"已创建"只是发了一条消息到飞书聊天里，实际什么都没创建。

绕路：内置 feishu 插件 + 飞书 CLI 链接到标题

既然飞书官方插件暂时不可用，替代方案是：OpenClaw 自带的 @openclaw/feishu 插件 + 飞书 CLI。

踩坑记录 on OHTLY Blog

OpenClaw 飞书能力实战：踩坑、绕路、最终打通云文档/日历/任务

为什么选飞书 链接到标题

踩坑：飞书官方插件 链接到标题

绕路：内置 feishu 插件 + 飞书 CLI 链接到标题

为什么选飞书链接到标题

踩坑：飞书官方插件链接到标题