// the find
AlexAnys/openclaw-feishu
飞书插件 × OpenClaw 保姆级配置指南 & 社区支持 （0328 - 更新飞书cli调用指南，增加 API 耗尽根因排查、Lark Webhook 内网穿透方案）
A configuration guide and TypeScript plugin for connecting Feishu (China) and Lark (international) to OpenClaw, an AI agent host formerly called Clawdbot. It started as an actual bridge implementation, then evolved into mostly documentation after OpenClaw shipped a built-in Feishu plugin. The code is still there but the project now primarily tells you to use something else.
The troubleshooting section is genuinely good — the API quota exhaustion bug gets a real root-cause explanation (health check polling bot/v3/info every 60 seconds) plus a specific fix command, not just 'try restarting'. The dual-mode architecture cleanly handles the Feishu vs Lark split: domestic users get WebSocket long-polling with no public URL required, Lark international users get Webhook mode with Cloudflare Tunnel instructions that actually work. The migration guide covers three plugin generations without burying you in conditionals — it gives you a decision table and lets you pick.
The project has quietly become a README with a plugin attached. The primary recommendation in the README is to use either the official Feishu plugin or OpenClaw's built-in plugin instead of this one — so most of those 689 stars are for documentation, not code. The plugin SDK dependency is a `.d.ts` declaration file against a closed-source host (`src/plugin-sdk.d.ts`), which means any OpenClaw internal change silently breaks the integration with no good way to detect it ahead of time. Test coverage is minimal — a unit test for group-filter logic and one text integration test, but nothing covering webhook signature validation, WebSocket reconnect behavior, or the media upload/download path. This is single-platform lock-in to a relatively young product; if OpenClaw changes its plugin API or goes commercial, this entire project's value disappears with it.