feishu-memory-recall

OpenClaw飞书代理的跨组内存、搜索和事件共享

# Feishu Memory Recall

Cross-group awareness for OpenClaw. Search messages, generate digests, and share events across all Feishu groups and DMs.

## Commands

| Command | Description |
|---|---|
| `recall --user <id> [--hours 24]` | Find messages from a user across all groups |
| `search --keyword <text> [--hours 24]` | Search messages by keyword across all groups |
| `digest [--hours 6]` | Activity summary of all tracked groups |
| `log-event -s <source> -e <text>` | Write event to RECENT_EVENTS.md + daily log |
| `sync-groups` | Auto-discover groups from gateway sessions |
| `add-group -i <id> -n <name>` | Manually track a group |
| `list-groups` | Show tracked groups |

## Usage

```bash
# Search for "GIF error" across all groups
node skills/feishu-memory-recall/index.js search -k "GIF" --hours 12

# What happened in all groups in the last 6 hours?
node skills/feishu-memory-recall/index.js digest --hours 6

# Log a cross-session event
node skills/feishu-memory-recall/index.js log-event -s "dev-group" -e "Fixed GIF crash in gateway"

# Auto-discover all Feishu groups from gateway sessions
node skills/feishu-memory-recall/index.js sync-groups

# Find what a specific user said recently
node skills/feishu-memory-recall/index.js recall -u ou_cdc63fe05e88c580aedead04d851fc04 --hours 48
```

## How It Works

1. **sync-groups**: Reads `~/.openclaw/agents/main/sessions/sessions.json` to auto-discover all Feishu groups the agent is connected to.
2. **search/recall/digest**: Calls Feishu API to fetch messages from tracked groups, filters by keyword/user/time.
3. **log-event**: Appends to both `RECENT_EVENTS.md` (rolling 24h cross-session feed) and `memory/YYYY-MM-DD.md` (permanent daily log).

## Configuration

Requires Feishu credentials in `.env`:
```
FEISHU_APP_ID=cli_xxxxx
FEISHU_APP_SECRET=xxxxx
```

Group list is stored in `memory/active_groups.json` and can be auto-populated via `sync-groups`.

---

## 中文说明

# 飞书记忆回溯

为 OpenClaw 提供跨群组感知能力。可在所有飞书群组和私信中搜索消息、生成摘要并共享事件。

## 命令

| Command | 说明 |
|---|---|
| `recall --user <id> [--hours 24]` | 在所有群组中查找某用户的消息 |
| `search --keyword <text> [--hours 24]` | 按关键词在所有群组中搜索消息 |
| `digest [--hours 6]` | 所有被跟踪群组的活动摘要 |
| `log-event -s <source> -e <text>` | 将事件写入 RECENT_EVENTS.md + 每日日志 |
| `sync-groups` | 从网关会话自动发现群组 |
| `add-group -i <id> -n <name>` | 手动跟踪某个群组 |
| `list-groups` | 显示被跟踪的群组 |

## 用法

```bash
# Search for "GIF error" across all groups
node skills/feishu-memory-recall/index.js search -k "GIF" --hours 12

# What happened in all groups in the last 6 hours?
node skills/feishu-memory-recall/index.js digest --hours 6

# Log a cross-session event
node skills/feishu-memory-recall/index.js log-event -s "dev-group" -e "Fixed GIF crash in gateway"

# Auto-discover all Feishu groups from gateway sessions
node skills/feishu-memory-recall/index.js sync-groups

# Find what a specific user said recently
node skills/feishu-memory-recall/index.js recall -u ou_cdc63fe05e88c580aedead04d851fc04 --hours 48
```

## 工作原理

1. **sync-groups**：读取 `~/.openclaw/agents/main/sessions/sessions.json`，自动发现代理已连接的所有飞书群组。
2. **search/recall/digest**：调用飞书 API 从被跟踪的群组获取消息，并按关键词/用户/时间过滤。
3. **log-event**：同时追加到 `RECENT_EVENTS.md`（滚动 24 小时的跨会话信息流）和 `memory/YYYY-MM-DD.md`（永久每日日志）。

## 配置

需要在 `.env` 中提供飞书凭证：
```
FEISHU_APP_ID=cli_xxxxx
FEISHU_APP_SECRET=xxxxx
```

群组列表存储在 `memory/active_groups.json` 中，可通过 `sync-groups` 自动填充。