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

为什么选飞书 链接到标题

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。

内置飞书插件负责消息收发，飞书 CLI 负责深度能力（任务、文档、日历等）。

飞书 CLI 安装过程 链接到标题

在飞书里给 OpenClaw 发送这条消息：

请按照该文档帮我安装飞书cli：
https://open.feishu.cn/document/mcp_open_tools/feishu-cli/set-up-lark-cli-for-ai-agents-in-openclaw_hermes.md

Agent 会自动读取文档并执行安装。安装完成后会提示选择身份模式：

Step 1 完成 ✅（CLI + 26 个飞书 skill 已安装）
现在需要你选择 AI 的身份模式：

As bot — 以机器人身份工作，有自己的身份标识。
As user — 以你的身份工作（发消息、操作文档、日历等）。需要授权。

选择 As user，然后它会要求扫码授权：

请扫码或在浏览器打开下面的链接完成授权：
https://accounts.feishu.cn/oauth/v1/device/verify?flow_id=xxx&user_code=xxx

扫码授权后，绑定完成：

绑定完成 ✅
状态：identity: user · tokenStatus: valid
现在可以通过 lark-cli 以你的身份操作飞书了
（消息、文档、日历、邮箱、云盘等）。
26 个飞书 skill 也已加载，告诉我你想做什么就好。

打通：测试任务创建 链接到标题

让 Agent 创建任务：

帮我创建一个飞书任务：公园晨练，明天早上 7 点

Agent 回复"已创建"。打开飞书 App 的任务列表，在"发送到此会话"里看不到，但在"全部任务"里能看到，飞书也会正常发送提醒。

一开始以为又失败了，后来排查发现这是正常现象：

“发送到此会话"只会显示通过该对话发送/创建的任务。用 lark-cli API 跳过了飞书客户端界面直接创建的，不属于"发送到这个会话”。任务已经创建成功——在全部任务里能看到，飞书会正常提醒。

云文档的测试也类似：文档正常创建在云盘里，创建人正是自己。

总结 链接到标题

飞书官方插件的能力很强大，等 OpenClaw 核心框架的 bug 修复后，可以直接切回官方插件获得更好的体验。在此之前，内置插件 + 飞书 CLI 的组合足够覆盖日常使用场景。