feishu-message

Reads Feishu messages by ID or lists recent chat history with time filters.

4.2k|441|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/m1heng/clawdbot-feishu --skill feishu-message
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-message
Source: https://github.com/m1heng/clawdbot-feishu/tree/main/skills/feishu-message
Command: npx skills add https://github.com/m1heng/clawdbot-feishu --skill feishu-message

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Retrieving past Feishu/Lark messages or looking up a specific message by ID normally requires manual scrolling through chats or writing custom API calls; this Skill exposes a single tool to fetch messages directly.

Core Features & Use Cases

  • Get Single Message: Retrieve full message content, sender, timestamps, and mentions by message ID (e.g., om_xxx).
  • List Recent Messages: List recent messages in a DM or group chat with configurable page size, sort order, and start/end time ranges.
  • Use Case: When a user asks "what did the team say about the release yesterday", the agent lists recent messages in the group chat filtered by a time range and summarizes the relevant discussion.

Quick Start

Ask the agent to list the last 20 messages in the current Feishu chat or to fetch a specific message by its message ID.

Frequently Asked Questions about feishu-message

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

FAQPage Schema
How do I read Feishu chat history with a bot?

Use the feishu_message tool with the list action to retrieve recent messages from a DM or group chat. You can set page_size up to 50, choose sort order, and filter by start_time and end_time Unix timestamps.

How to get a single Feishu message by message ID?

Call the feishu_message tool with action set to get and pass the message_id such as om_xxx. It returns the message content, sender ID, chat ID, timestamps, and mentions.

What permissions are needed to read Feishu group messages?

Reading single or DM messages requires im:message or im:message:readonly. Reading all messages in group chats, not just messages mentioning the bot, requires im:message.group_at_msg:readonly.

Can I filter Feishu messages by time range?

Yes, the list action accepts start_time and end_time as Unix timestamps in seconds. Omitting them removes the lower or upper bound, and results default to newest first.

Why does message listing only show bot-mentioned messages in groups?

Without the im:message.group_at_msg:readonly scope, the Feishu API only exposes messages that mention the bot in group chats. Grant that permission in the Feishu app console to read all group messages.