Skip to content

Astro-Han/openclaw-lark

 
 

Repository files navigation

OpenClaw Lark/Feishu Plugin

License: MIT npm version Node.js Version

中文版 | English

This is the official Lark/Feishu plugin for OpenClaw, developed and maintained by the Lark/Feishu Open Platform team. It seamlessly connects your OpenClaw Agent to your Lark/Feishu workspace, enabling it to directly read from and write to messages, docs, bases, calendars, tasks, and more.

Features

This plugin provides comprehensive Lark/Feishu integration for OpenClaw, including:

Category Capabilities
💬 Messenger Read messages (group/DM history, thread replies), send messages, reply to messages, search messages, download images/files
📄 Docs Create, update, and read documents
📊 Base Create/manage bases, tables, fields, records (CRUD, batch operations, advanced filtering), views
📈 Sheets Create, edit, and view spreadsheets
📅 Calendar Manage calendars and events (create/query/update/delete/search), manage attendees, check free/busy status
✅ Tasks Manage tasks (create/query/update/complete), manage task lists, subtasks, and comments

Additionally, the plugin supports:

  • 📱 Interactive Cards: Real-time status updates (Thinking/Generating/Complete), plus confirmation buttons for sensitive operations
  • 🌊 Streaming Responses: Live streaming text directly within message cards
  • 🔒 Permission Policies: Flexible access control policies for DMs and group chats
  • ⚙️ Advanced Group Configuration: Per-group settings including allowlists, skill bindings, and custom system prompts

Security & Risk Warnings (Read Before Use)

Core risk: This plugin connects to your work data via Lark/Feishu APIs—messages, docs, calendars, contacts. Anything the AI can read could theoretically be leaked. While we have implemented security protections, AI systems are not yet mature or stable enough to guarantee absolute safety.

Strong recommendations:

  • Use a personal account for evaluation and testing at this stage.
  • Use the related Lark/Feishu apps personally, and avoid deploying to large numbers of users.
  • Avoid using it in group chats to reduce the risk of data exposure.
  • Using this bot for multiple users and/or with a company Feishu account may introduce data security and privacy risks. Make sure you comply with your organization’s internal data security and privacy requirements to avoid data leakage, privilege escalation, privacy violations, or related consequences.

Other operational risks

  • AI is not perfect and may hallucinate: It may sometimes misunderstand your intent or generate content that appears reasonable but is inaccurate.
  • Some operations are irreversible: For example, messages sent by the AI on your behalf are sent in your name and cannot be undone once sent.
  • Mitigation advice: For important operations involving sending, modifying, or writing data, always preview first, then confirm. Never allow the AI to operate in a fully autonomous mode without human oversight.

Disclaimer:

This software is licensed under the MIT License. When running, it calls Lark/Feishu Open Platform APIs. To use these APIs, you must comply with the following agreements and privacy policies:

Requirements & Installation

Before you start, make sure you have the following:

  • Node.js: v22 or higher.
  • OpenClaw: OpenClaw is installed and works properly. For details, visit the OpenClaw official website.

Note: OpenClaw version must be 2026.2.26 or higher. Check with openclaw -v. If below this version, you may encounter issues. Upgrade with:

npm install -g openclaw

Usage Guide

How to Use the Official Lark/Feishu Plugin for OpenClaw

Contributing

Community contributions are welcome! If you find a bug or have feature suggestions, please submit an Issue or a Pull Request.

For major changes, we recommend discussing with us first via an Issue.

License

This project is licensed under the MIT License. See LICENSE for details.

About

飞书官方出品的 OpenClaw 飞书/Lark Channel 插件

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 99.8%
  • JavaScript 0.2%