← Back to Skills Marketplace
taype

Feishu Report Summary

by taype · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
260
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install feishu-report-summary
Description
Read Feishu work-report data through the Report v1 API and turn it into daily or weekly summaries. Use when Codex needs to work with `oa.feishu.cn/report/......
README (SKILL.md)

Feishu Report Summary

Use this skill when the user wants a summary of Feishu 汇报 data and the source link is under oa.feishu.cn/report/.... The bundled script calls the Feishu Report API directly, using the same credentials already stored in ~/.openclaw/openclaw.json.

Workflow

  1. Run scripts/fetch_report_tasks.js for the target day or range.
  2. Prefer --format json when you will analyze the results in-model.
  3. Prefer --format markdown when the output will be reviewed or copied directly.
  4. Summarize with the structure in references/summary-template.md unless the user asks for a different format.
  5. If the user wants the digest published back to Feishu, use existing feishu_doc or feishu_chat tools after the summary is drafted.

Quick Start

Fetch today's local-calendar reports as JSON:

node scripts/fetch_report_tasks.js --format json

Fetch one day and cap the export:

node scripts/fetch_report_tasks.js --date 2026-03-14 --max-items 50 --format json

Fetch one rule for the last 7 days and render Markdown:

node scripts/fetch_report_tasks.js --days 7 --rule-name "研发团队工作日报" --format markdown

Write the export to a file for later review:

node scripts/fetch_report_tasks.js --date 2026-03-14 --output /tmp/feishu-report.md

Script Notes

  • The script reads Feishu credentials from ~/.openclaw/openclaw.json by default.
  • Use --account-id when multiple Feishu accounts are configured.
  • --date, --start-date, --end-date, and --days use the machine's local timezone.
  • Use FEISHU_APP_ID and FEISHU_APP_SECRET only when you need to override config values.
  • The script resolves --rule-name to a rule ID before querying tasks so the final query stays precise.

Expected Output

The JSON payload contains:

  • query range metadata
  • resolved filters
  • task counts grouped by rule and reporter
  • normalized task entries with field names and pretty-printed field values

Use that payload to produce a concise digest that highlights:

  1. common themes
  2. completed work
  3. blockers or risks
  4. next actions
  5. people or teams that need follow-up
Usage Guidance
This skill appears to do what it says: run the bundled Node script to fetch Feishu report entries and produce summaries. Before installing or running it, check these points: 1) Inspect your ~/.openclaw/openclaw.json — the script will read that file for appId/appSecret (and may read other channel config). Do not run the script if that file contains unrelated secrets you don't want accessed. 2) The script runs system commands (npm, which) and dynamically requires the @larksuiteoapi/node-sdk from your local OpenClaw installation; that means code from your local node_modules may execute. If you don't trust your installed OpenClaw package, run the script in an isolated environment or review the local package contents. 3) You can override credentials with FEISHU_APP_ID and FEISHU_APP_SECRET environment variables; the script will fail if appSecret is a secret-store reference (secret://). 4) No external downloads or unexpected network endpoints are present in the manifest, but always review the full script (scripts/fetch_report_tasks.js) before running. If you want higher assurance, run the script on a machine/account that contains only the Feishu credentials you intend to use.
Capability Analysis
Type: OpenClaw Skill Name: feishu-report-summary Version: 1.0.0 The skill is a legitimate tool for fetching and summarizing Feishu work reports. The primary script, `scripts/fetch_report_tasks.js`, reads Feishu API credentials from the standard OpenClaw configuration file (~/.openclaw/openclaw.json) and uses the official Lark/Feishu SDK to query report data. The code logic is transparent, follows its stated purpose in SKILL.md, and contains no evidence of data exfiltration, unauthorized network calls, or malicious persistence mechanisms.
Capability Assessment
Purpose & Capability
The skill claims to read Feishu Report API data and summarize it. The included script contacts Feishu using appId/appSecret found in ~/.openclaw/openclaw.json or via FEISHU_APP_ID/FEISHU_APP_SECRET overrides, resolves rule IDs, queries tasks, and renders JSON/Markdown. These requirements match the stated purpose.
Instruction Scope
SKILL.md instructs the agent to run the bundled Node script and to read credentials from ~/.openclaw/openclaw.json (with optional FEISHU_* env overrides). That is in-scope for fetching Feishu reports. The instructions do not ask to exfiltrate unrelated data. Note: the script also runs system commands (npm, which) and resolves local OpenClaw installation paths at runtime — these actions are functional for locating the Lark/Feishu SDK but increase the attack surface and should be expected.
Install Mechanism
No install spec is present (instruction-only with a bundled script). Nothing is downloaded from external URLs. The script relies on the local Node environment and the user's OpenClaw installation.
Credentials
No new credentials are required by the skill manifest, which matches SKILL.md that reads credentials from ~/.openclaw/openclaw.json or FEISHU_APP_ID/FEISHU_APP_SECRET. This is proportional to the task. Caveat: the script reads the entire OpenClaw config file from the user's home directory and will error if appSecret is a secret store reference (secret://). Review openclaw.json for other secrets or unexpected content before running.
Persistence & Privilege
The skill is not force-installed (always:false) and does not request system-wide persistence. It does execute local binaries and dynamically require code from the user's OpenClaw installation, but it does not modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install feishu-report-summary
  3. After installation, invoke the skill by name or use /feishu-report-summary
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of feishu-report-summary. - Adds ability to fetch and summarize Feishu work-report data via the Report v1 API. - Supports generating daily or weekly digests from `oa.feishu.cn/report/...` entries. - Provides CLI script for fetching reports with various filters and output formats (JSON, Markdown). - Summaries highlight themes, completed work, blockers, next actions, and follow-ups. - Designed to fill gaps in the default OpenClaw Feishu plugin, which lacks direct report tooling.
Metadata
Slug feishu-report-summary
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Feishu Report Summary?

Read Feishu work-report data through the Report v1 API and turn it into daily or weekly summaries. Use when Codex needs to work with `oa.feishu.cn/report/...... It is an AI Agent Skill for Claude Code / OpenClaw, with 260 downloads so far.

How do I install Feishu Report Summary?

Run "/install feishu-report-summary" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Feishu Report Summary free?

Yes, Feishu Report Summary is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Feishu Report Summary support?

Feishu Report Summary is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Feishu Report Summary?

It is built and maintained by taype (@taype); the current version is v1.0.0.

💬 Comments