lark-vc-agent

Join Lark video meetings as a bot and read live in-meeting events.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill lark-vc-agent-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-vc-agent
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/lark-vc-agent
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill lark-vc-agent-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? It lets an application bot actually join an in-progress Lark (Feishu) video meeting, read real-time in-meeting events such as participant joins/leaves, chat, transcripts, and screen shares, and leave the meeting on request—capabilities that post-meeting query tools cannot provide. ## Core Features & Use Cases - Bot meeting join/leave: Join an ongoing meeting by 9-digit meeting number with the app identity, and leave by long numeric meeting_id when the user explicitly asks. - Live event streaming: Read in-meeting events (participant_joined, chat_received, transcript_received, magic_share_started) via +meeting-events with identity-consistent access and full pagination. - Active meeting discovery: Find the long numeric meeting_id for the current user or for a target user where the bot is also present, including matching by 9-digit meeting number. - Use Case: A user says "let the bot sit in on meeting 123456789 and tell me what is being discussed"—the skill joins the meeting, polls the event stream, and summarizes the latest discussion, reading any shared document before summarizing. ## Quick Start Ask the assistant to join Lark meeting 123456789 with the app bot and report what is currently happening in the meeting.

Frequently Asked Questions about lark-vc-agent

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

FAQPage Schema
How do I make a Lark bot join a video meeting?

Use `lark-cli vc +meeting-join --as bot --meeting-number <9-digit number>` with the app identity. The meeting must be in progress, and the returned meeting.id must be saved for later event reads or leaving the meeting.

How to read live events from an ongoing Lark meeting?

Call `lark-cli vc +meeting-events --meeting-id <long numeric id> --page-all` using the same identity that discovered the meeting_id. It returns participant joins/leaves, chat, transcripts, and screen share events.

What is the difference between lark-vc and lark-vc-agent?

lark-vc handles post-meeting queries like searching past meetings, participant snapshots, notes, transcripts, and recordings. lark-vc-agent handles in-meeting actions: bot join, live event reading, active meeting discovery, and leaving.

Why does reading meeting events fail with bot is not in meeting?

Error 10005 means the app bot never actually joined that meeting, or the meeting ended over 5 minutes ago. Either join first with +meeting-join, or use the user identity if the meeting_id came from user-identity discovery.

Can I use a 9-digit meeting number to query meeting events?

No, +meeting-events requires the long numeric meeting_id. Match the 9-digit number against `meeting_no` in +meeting-list-active results to get the meeting_id, then read events with the same identity.

What permissions does the Lark VC Agent feature require?

It is in beta and requires VC Agent scopes, app installation in the tenant, and data scope configured as meeting owner matching the app's availability range. Error 20017 or ErrNotInGray means the graylist whitelist is not enabled.