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.