lark-im

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

Updated May 22, 2026
One-click install
npx skills add https://github.com/CalWade/aigc-creator --skill lark-im-calwade
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-im
Source: https://github.com/CalWade/aigc-creator/tree/main/.agents/skills/lark-im
Command: npx skills add https://github.com/CalWade/aigc-creator --skill lark-im-calwade

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? It lets an AI agent operate Lark (Feishu) instant messaging on your behalf: sending and replying to messages, searching chat history, downloading message attachments, managing group members, bookmarks, feed shortcuts, and feed groups without manual app interaction. ## Core Features & Use Cases - Messaging: Send, reply, forward, recall, and batch-fetch messages in group chats or P2P conversations, with thread support and automatic reaction enrichment. - Chat Management: Create group or topic chats, search chats by keyword or member, update names/descriptions, and manage members with correct user/bot identity selection. - Resources & Organization: Download images/files (including chunked large-file downloads), manage emoji reactions, pins, message flags, feed shortcuts, and feed groups (tags). - Use Case: Ask the agent to find the "release team" group, pull the last 50 messages with attachments downloaded, then reply with a summary — all executed through lark-cli im shortcuts. ## Quick Start Ask the agent to send a message to a Lark group by name, for example: "Find the group named Project Sync and send 'Standup starts in 10 minutes' to it."

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 Lark group chat from the command line?▼

Use the shortcut `lark-cli im +messages-send --chat-id oc_xxx --text "hello"`. If you only know the group name, first run `lark-cli im +chat-search --query "name"` to resolve the chat_id, then send.

How do I search Lark chat history by keyword?▼

Run `lark-cli im +messages-search` with user identity, filtering by keyword, sender, chat, or time range. It supports auto-pagination via `--page-all` and enriches results with sender names.

What is the difference between --as user and --as bot in lark-cli im?▼

`--as user` uses a user_access_token and acts as the authorized end user; `--as bot` uses a tenant_access_token and acts as the app bot. Permissions, chat membership, and visibility checks differ, so the same API can succeed with one identity and fail with the other.

Can I download files and images from Lark messages?▼

Yes. Use `lark-cli im +messages-resources-download` for one-off downloads, or pass `--download-resources` to message-listing commands to save eligible resources into ./lark-im-resources/. Large files are downloaded in 8MB chunks; stickers are not downloadable.

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

Error 232043 means the bot and target users are mutually invisible. Create the group with the bot first, then add members with user identity via `lark-cli im chat.members create --as user`.

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

Under bot identity, sender names cannot be resolved when the app's visibility range does not cover those users. Expand the app's visible range in the Lark Developer Console or fetch messages with `--as user`.