飞书汇报查询

要解决什么问题

在飞书里查「谁写了什么汇报、某段时间内自己的提交记录、某部门规则下某人的历史汇报」，常见做法是进多维表或手工翻客户端。本技能 不依赖多维表，直接调用飞书 汇报开放接口（/open-apis/report/v1/rules/query 与 /tasks/query），拉取汇报模块里的规则与任务数据，适合在 Agent 或 OpenClaw 工作流里做结构化查询。

核心能力与用法思路

| 能力 | 说明 |
|------|------|
| useraccesstoken | 以当前登录用户身份查自己的汇报（my），无需单独配 app_id |
| 自然语言日期 | 支持「今天」「昨天」「本周」「上周」「本月」「上月」「最近 N 天」等 |
| 关键词搜索 | 在汇报内容里搜关键词，可配合规则 ID 与时间范围 |
| who / SOP | 部门名 → 汇报规则 → 指定人员：先确认部门，规则名 通常与部门名一致（不一定带「规则」二字） |

典型 CLI 形态包括：rules 搜规则、who 部门 姓名 --when "上周" 查他人、my --when "本周" 查自己、search 做内容检索、tasks 自由组合 rule / user / 起止日期。

权限与凭证注意点

飞书开发者后台需开启 report:rule:readonly、report:task:readonly；可选 contact:user.base:readonly 用于解析姓名。凭证优先级：user_access_token（my 时由 OpenClaw 获取）→ 环境变量 FEISHU_APP_ID / FEISHU_APP_SECRET → ~/.openclaw/openclaw.json 中 channels.feishu 配置。查他人汇报时若规则名与部门名对不上，优先用 部门原名 搜规则，避免按习惯加「规则」后缀导致搜不到。