{
  "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:

{
  "action": "list"
}

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

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

Returns:

{
  "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

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)

feishu-message

Feishu Message Tool

Actions

Get Single Message

More from m1heng/clawdbot-feishu

feishu-doc

feishu-drive

feishu-wiki

feishu-perm

feishu-task

agent-browser