# Feishu Im Read

> When 飞书 chat history needs reading → fetch group/DM messages, thread replies, and download attached files/images.

- Skill: `cklxx/feishu-im-read` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cklxx/feishu-im-read`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cklxx/feishu-im-read/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cklxx (https://skillmd.com/u/cklxx)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/cklxx/feishu-im-read

---


# Feishu IM Read Skill

## 快速索引

| 用户意图 | module | tool_action | 必填参数 |
|---------|--------|-------------|---------|
| 发送消息 | message | send_message | chat_id/user_id, content |
| 读取消息历史 | message | history | chat_id |
| 上传文件 | message | upload_file | source, file_type |

## 调用示例

### 发送消息

```bash
python3 skills/feishu-cli/run.py '{
  "action": "tool",
  "module": "message",
  "tool_action": "send_message",
  "chat_id": "oc_xxx",
  "content": "Hello! 这是一条测试消息"
}'
```

### 读取消息历史

```bash
python3 skills/feishu-cli/run.py '{
  "action": "tool",
  "module": "message",
  "tool_action": "history",
  "chat_id": "oc_xxx",
  "start_time": "2026-03-01",
  "end_time": "2026-03-10",
  "page_size": 20
}'
```

## 核心约束

- **chat_id**: 群聊 ID（`oc_` 开头）；**必填**——可通过参数直传，或由环境变量 `LARK_CHAT_ID` 自动注入（Lark channel 中默认已注入）
- **user_id**: 用户 open_id（`ou_` 开头），用于私聊
- **消息类型**: 支持 text、post（富文本）、image、file 等
- **分页**: 使用 `page_token` 和 `page_size` 进行分页
- **时间过滤**: `start_time` 和 `end_time` 支持日期字符串

