飞书 on OHTLY Blog

告警通知到飞书：Alertmanager → OpenClaw 中转方案

Fri, 29 May 2026 19:10:00 +0800

前两篇介绍了用 Alloy + Loki Ruler 实现日志告警：

CouchDB 日志监控：文本日志的 LogQL 告警
Windmill 日志监控：JSON 日志的 LogQL 告警

两条链路最终都汇入 Alertmanager，由它统一分派到飞书。但 Alertmanager 原生没有飞书 receiver——它的 webhook 输出的是原始 JSON，飞书看不懂。中间需要一层适配器来转换格式。这个适配器就是 alert-transformer。

OpenClaw 异步通知：Agent Turn 与 Wake 选型指南

Wed, 27 May 2026 19:20:00 +0800

为什么需要这个链接到标题

AI Agent 经常需要执行耗时较长的异步任务（视频剪辑、字幕生成、模型推理等）。任务完成后，如何通知用户？

有三种常见实现方式：

方式	过程	优点	缺点
同步等待	发起任务 → 一直等到完成 → 返回结果	实现简单	长时间阻塞，用户体验差
异步轮询	发起任务 → 拿到 job_id → 不断查询 → 完成	不阻塞	对话不能断开，浪费 token
异步+通知	发起任务 → 返回"已提交" → 完成后主动推送	体验最好，资源最优	需要服务端支持回调

OpenClaw 的独特优势在于它拥有 Webhook/Hook 机制，可以作为服务端接收外部回调，主动推送消息到飞书。

对比其他 AI 工具：

OpenCode / Claude Code：纯 CLI 工具，只有"触发→等待→返回"的模式，没有回调机制
OpenClaw：内置 Gateway 服务，支持 /hooks/* 端点，天然适合异步回调

所以 “异步+通知” 是 OpenClaw 的场景的最优解。

整体架构链接到标题

sequenceDiagram participant U as 用户（飞书） participant O as OpenClaw Agent participant W as Windmill / 外部系统 participant H as OpenClaw Hook U->>O: 发消息处理这个视频 O->>W: API 调用（异步） O-->>U: 任务已提交 Note over W: 几分钟后... W-->>H: POST /hooks/agent H->>H: 创建 Agent Turn H->>U: 飞书消息（带下载链接）

Agent Turn 与 Wake 链接到标题

OpenClaw 提供了两种代码触发的消息通知方式，它们都通过 Gateway 的 /hooks/* 端点实现。

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。