lark-event

Subscribe to Feishu events via WebSocket and output NDJSON.

3|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/agent-pilot/agent-pilot-be --skill lark-event-agent-pilot
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-event
Source: https://github.com/agent-pilot/agent-pilot-be/tree/main/backend/skills/lark-event
Command: npx skills add https://github.com/agent-pilot/agent-pilot-be --skill lark-event-agent-pilot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Subscribing to Feishu/Lark events in real time can be complex due to the need for WebSocket connections, proper authentication, and structured output. This Skill provides a ready-made workflow to subscribe to events via a long-lived WebSocket, stream NDJSON to stdout, and emit outputs in an agent-friendly format with optional routing to files or directories.

Core Features & Use Cases

  • Real-time event subscription via WebSocket long connection for Feishu events (e.g., messages, contact updates, and calendar changes), outputting NDJSON to stdout.
  • Supports a compact agent-friendly format, regex-based routing, and file output for event-driven pipelines.
  • Shortcuts and CLI workflows (e.g., lark-cli event +subscribe) to streamline common operations; integrates with lark-shared SKILL.md for authentication and safety rules.

Quick Start

Run lark-cli event +subscribe to start receiving Feishu events in real time.

Frequently Asked Questions about lark-event

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I subscribe to Feishu events in real time via WebSocket?▼

To subscribe to Feishu events in real time, you can use a WebSocket long connection that streams NDJSON output to stdout. This approach handles bot-only usage and supports various event types like im.message.receive_v1 and calendar updates.

What is the best way to route Feishu event subscriptions using regex?▼

Routing Feishu event subscriptions using regex allows you to direct specific NDJSON event streams to designated files or directories. This creates structured, agent-friendly output pipelines for various event types like contact updates.

Do I need lark-cli to receive Lark bot events through a WebSocket connection?▼

Yes, you need lark-cli to receive Lark bot events through a WebSocket connection. It manages the authentication, permissions, and safety rules required to establish the long-lived connection and output NDJSON.

Can I output Feishu message events to a file for event-driven pipelines?▼

Yes, you can output Feishu message events to a file for event-driven pipelines. The subscription supports optional file output alongside streaming NDJSON to stdout, enabling flexible event routing and logging.

Does the Feishu WebSocket event subscription support calendar updates?▼

Yes, the Feishu WebSocket event subscription supports calendar updates. It handles various event types including im.message.receive_v1 and contact updates, outputting them in a compact NDJSON format.