---
id: m1heng/clawdbot-feishu/feishu-message
version: "5d91d9ed"
license: MIT
install: manual
updated: 2026-03-29
---

# feishu-message — Feishu Message lets you retrieve specific messages using their ID or browse recent activity in any chat. Customize your search with page size, sort order, and time range filters to find exactly what you need.

Publisher: m1heng · Stars: 4264 · Updated: 2026-03-29

Install (manual): `git clone https://github.com/m1heng/clawdbot-feishu`

## SKILL.md

# Feishu Message Tool

Single tool `feishu_message` for reading Feishu messages — get a single message by ID or list recent messages in a chat.

## Actions

### Get Single Message

```json
{
  "action": "get",
  "message_id": "om_xxx"
}
```

Returns:

```json
{
  "ok": true,
  "action": "get",
  "found": true,
  "message_id": "om_xxx",
  "msg_type": "text",
  "content": "Hello world",
  "sender_id": "ou_xxx",
  "sender_type": "user",
  "chat_id": "oc_xxx",
  "create_time": "1710000000000",
  "update_time": "1710000000000",
  "mentions": []
}
```

### List Recent Messages

List recent messages in a chat (DM or group), newest first by default.
Omit `chat_id` to use the current conversation's chat:

```json
{
  "action": "list"
}
```

With custom page size, sort order, and time range:

```json
{
  "action": "list",
  "chat_id": "oc_xxx",
  "page_size": 20,
  "sort_type": "ByCreateTimeAsc",
  "start_time": "1710000000",
  "end_time": "1710086400"
}
```

Returns:

```json
{
  "ok": true,
  "action": "list",
  "chat_id": "oc_xxx",
  "total": 10,
  "messages": [
    {
      "message_id": "om_xxx",
      "msg_type": "text",
      "content_preview": "Hello world",
      "sender_id": "ou_xxx",
      "sender_type": "user",
      "create_time": "1710000000000",
      "chat_id": "oc_xxx"
    }
  ]
}
```

## Parameters

| Parameter | Required | Description |
|-----------|----------|-------------|
| `action` | Yes | `get` or `list` |
| `message_id` | get: Yes | Feishu message ID (e.g., `om_xxx`) |
| `chat_id` | list: Optional | Chat ID (e.g., `oc_xxx`). Omit to use current chat. |
| `page_size` | list: Optional | Number of messages (default: 10, max: 50) |
| `sort_type` | list: Optional | `ByCreateTimeDesc` (default) or `ByCreateTimeAsc` |
| `start_time` | list: Optional | Unix timestamp in seconds (e.g., `"1710000000"`). No lower bound if omitted. |
| `end_time` | list: Optional | Unix timestamp in seconds (e.g., `"1710086400"`). No upper bound if omitted. |

## Configuration

```yaml
channels:
  feishu:
    tools:
      message: true  # default: true
```

## Permissions

- `im:message` or `im:message:readonly` — read single/DM messages
- `im:message.group_at_msg:readonly` — read all messages in group chats (not just @bot messages)


[View on SkillFed](https://skillfed.io/m1heng/clawdbot-feishu/feishu-message) · [View on GitHub](https://github.com/m1heng/clawdbot-feishu)