lark-im

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

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-im-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-im
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/lark-im
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-im-yuezhen-huang

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 end to end: sending and replying to messages, searching chat history, managing group chats and members, downloading message attachments, and handling emoji reactions, all through the lark-cli command line. ## Core Features & Use Cases - Message Operations: Send text, Markdown, post, image, file, video, and audio messages to chats or direct messages, reply in threads, and recall or forward messages. - Search & Retrieval: Search messages across chats with sender, time, and attachment filters, list chat or thread messages, and batch-fetch message details with resolved sender names. - Group Chat Management: Create private or public groups, update names and descriptions, search visible chats, and manage members with correct user/bot identity selection. - Use Case: A user asks the agent to find last week's discussion about a release in a project group, summarize it, and post a reply in the thread — the agent searches messages, expands the thread, and replies after user confirmation. ## Quick Start Ask the agent to send a message like "send 'Build passed' to the release group" and it will resolve the chat, confirm the content and identity with you, then deliver it via lark-cli.

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

Use lark-cli im +messages-send with --chat-id oc_xxx and --text for plain text, or --markdown for formatted content. You must confirm the recipient, content, and identity (user or bot) before sending.

How to search Feishu chat history by keyword or sender?

Use lark-cli im +messages-search with --query, --sender, --chat-id, and time range filters. It is user-identity only and supports auto-pagination via --page-all for complete result sets.

What is the difference between --as user and --as bot in Feishu IM APIs?

--as user uses a user access token and acts as the authorized end user, while --as bot uses a tenant access token and acts as the app bot. The same API can succeed with one identity and fail with the other due to membership, visibility, and scope differences.

Why does creating a Feishu group fail with error 232043?

Error 232043 means the bot and target users are mutually invisible. Create the group with only the current user first, then add other members with user identity via chat.members create.

Can I download images and files from Feishu messages?

Yes, use lark-cli im +messages-resources-download with the message_id and file_key from message content, specifying --type image or file. Files over 100 MB cannot be downloaded due to a Feishu API limit.

Why do sender names show as open_id when a bot fetches messages?

The bot cannot resolve names when the app's visibility settings do not cover the message senders. Expand the app's visible range in the Lark Developer Console or fetch messages with --as user instead.