skills.rest
Pinvou
PinvouOFFICIAL
Explore all skills by this author →
GitHub

lark-im

Send messages and manage group chats in Feishu/Lark via lark-cli.

2.0k|291|Updated Jul 24, 2026
Search Tags:#feishu#lark#lark-cli#message search#group chat#instant messaging#interactive card
One-click install
npx skills add https://github.com/Pinvou/pinvou-agent --skill lark-im-pinvou
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-im
Source: https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-im
Command: npx skills add https://github.com/Pinvou/pinvou-agent --skill lark-im-pinvou

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? It lets an AI agent operate Feishu/Lark instant messaging on your behalf: sending and replying to messages, searching chat history, managing group members, and handling interactive cards without manually calling the Lark OpenAPI. ## Core Features & Use Cases - Messaging: Send, reply, edit, forward, and recall messages; search messages across chats; download images and files from conversations. - Group Management: Create group or topic chats, list and search chats, manage members, managers, moderation, join requests, pins, and feed shortcuts/groups. - Interactive Cards: Build and update interactive cards and handle card.action.trigger button/form callbacks with delayed updates. - Use Case: Ask the agent to find the "daily report" group, read the latest messages, and post a summary reply — it resolves the chat_id, fetches history, and sends the message via lark-cli shortcuts. ## Quick Start Send a message saying "Hello team" to the Feishu group named Project Discussion using the lark-im skill.

Frequently Asked Questions about lark-im

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

FAQPage Schema
How do I send a message to a Feishu group chat?▼

Use the +messages-send shortcut with a chat_id or user open_id, for example lark-cli im +messages-send --chat-id oc_xxx --text "hello". If you only know the group name, resolve its chat_id first with +chat-search.

How do I find a Lark group chat id by name?▼

Run lark-cli im +chat-search --query "<keyword>" to search visible group chats by name, member, or pinyin. Do not use +chat-list as a fallback, since it is not a search API and returns all chats without keyword filtering.

Should I use user identity or bot identity for Lark IM operations?▼

It depends on the operation: feed shortcuts, flags, and p2p listing are user-only, while urgent messages and merge_forward are bot-only. If unspecified, infer the owner identity from context, and switch identities only with the user's explicit consent.

Can I download files and images from Lark chat messages?▼

Yes, use +messages-resources-download for a single attachment or add --download-resources to message-listing shortcuts to save eligible resources into ./lark-im-resources/. Stickers are not downloadable, and folder resources must be expanded first with im files folder --recursive.

Why does creating a group with a bot fail with error 232043?▼

Error 232043 means the bot and the invited users are mutually invisible, so the whole creation request fails. Create the group with the bot first, then add members with user identity via chat.members create using succeed_type=1.

How do I handle interactive card button callbacks in Feishu?▼

Consume card.action.trigger events with lark-cli event consume, then update the card via the delayed-update API using the event token within 30 minutes and at most 2 uses. Card 1.0 updates must include open_ids containing the operator's open_id.

Related Skills

Explore More Content & Communication Skills→
sugarforeversugarforever
131

add-feishu

Integrate Feishu messaging via WebSocket long-polling with app credentials.

Community
Intermediate
alextangsonalextangson
65

feishu-card

Send interactive Feishu cards with JSON payloads and WebSocket callbacks.

Community
Intermediate
yokingmayokingma
35

lark-contact

Resolve Lark/Feishu contact names or emails into open_id values.

Community
Intermediate
heximaoheximao

lark-im

Manages chats, messages, and threads through the Lark API.

Community
Advanced