lark-im

Send, search, and manage Feishu messages and group chats via lark-cli.

Updated Jan 10, 2026
One-click install
npx skills add https://github.com/Rabbit-Ivan/Ivan-skills --skill lark-im-rabbit-ivan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-im
Source: https://github.com/Rabbit-Ivan/Ivan-skills/tree/main/skills/lark-im
Command: npx skills add https://github.com/Rabbit-Ivan/Ivan-skills --skill lark-im-rabbit-ivan

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 directly from the command line: sending and replying to messages, searching chat history, managing group chats and members, and downloading message attachments without manual app interaction. ## Core Features & Use Cases - Message Operations: Send text, markdown, rich-text, image, file, video, and audio messages to group chats or direct messages, reply in threads, and add emoji reactions. - Chat Management: Create private or public groups, update names and descriptions, search visible chats by keyword or member, and manage members with correct user/bot identity selection. - History & Retrieval: List conversation messages, search messages across chats with sender/time/attachment filters, expand thread replies, and download images or files from messages. - Use Case: Ask the agent to find the "project weekly" group, pull all messages from the past week, and send a summarized progress report back to the group. ## Quick Start Use the lark-im skill to search my Feishu chats for the group named "Project Discussion" and send a message saying the weekly report is ready.

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 Feishu message from the command line?▼

Use the lark-cli im +messages-send shortcut with --chat-id for groups or --user-id for direct messages, plus --text, --markdown, or media flags like --image and --file. Sending uses bot identity and requires the im:message:send_as_bot scope.

How to search Feishu chat history by keyword?▼

Run lark-cli im +messages-search with --query and optional filters like --chat-id, --sender, --start, and --end. It is user-identity only and automatically fetches full message content and chat context for the results.

Should I use user identity or bot identity for Feishu group operations?▼

Message sending and group creation are bot-only, while message search is user-only. For adding members or updating groups, prefer the identity that owns or administers the chat, since bot visibility limits often cause errors like 232043 or 232024.

Why does adding members during Feishu group creation fail with error 232043?▼

Error 232043 means the bot and target users are mutually invisible. Create the group with the bot first, then add other users with a user-identity chat.members create call instead of passing them in --users during creation.

Can I download images and files from Feishu messages?▼

Yes, use lark-cli im +messages-resources-download with the message_id, file_key, and --type image or file. The file_key comes from message content returned by +chat-messages-list, and files over 100 MB cannot be downloaded.

Why are sender names shown as open_id instead of display names?▼

When fetching messages with bot identity, the bot may lack contact visibility for the sender, so names cannot be resolved. Expand the app's visibility range in the Lark Developer Console or fetch messages with --as user instead.