A field guide to marrying OpenClaw and Feishu

What it does

This repo is a living handbook for connecting the OpenClaw AI agent platform to Feishu (Lark). It documents three different integration paths—Feishu’s official plugin, OpenClaw’s built-in community plugin, and the now-legacy original bridge—and walks through setup, migration, and troubleshooting for each. Think of it as the translation layer between two rapidly moving codebases.

The interesting bit

Rather than shipping code, the repository has pivoted into a meta-guide that tracks an evolving integration landscape. It even covers Feishu’s newly open-sourced Lark CLI, a 2,500-API toolkit that lets an AI agent operate Feishu directly through OAuth as if it were the user. The author also maintains a companion repo of 39 China-ecosystem use cases.

Key highlights

• Side-by-side comparison of the official Feishu plugin (user identity, full document/calendar/task access) versus the OpenClaw built-in plugin (bot identity, lighter permissions, chat-focused).
• Troubleshooting deep-dives, including API quota exhaustion root-cause analysis and Lark Webhook intranet-penetration workarounds.
• Migration guides for users still running the discontinued legacy plugin from this repo.
• Coverage of the official Lark CLI with 19 AI Agent Skills across 11 business domains.
• Links to a curated collection of 39 real-world use cases adapted for Chinese platforms like Feishu, DingTalk, and Xiaohongshu.

Caveats

• The original plugin code in this repository is no longer maintained; users are pushed toward the official or built-in alternatives.
• The two active plugins are mutually exclusive—installing both triggers a duplicate plugin id error that breaks Feishu functionality until manually cleaned up.
• OpenClaw 3.x users hitting a version-check bug in the official onboarding tool must bypass it with a manual install command.

Verdict

Worth bookmarking if you are running OpenClaw inside a Feishu workspace and need to pick the right integration strategy. Skip it if you are looking for a library to import; this is documentation, not shipping code.