name: file-summary description: | local document summary & analysis tool. triggers: 幫我總結, 總結檔案, 分析文件, 分析總結, 總結一下, 分析一下 summarize for me, analyze for me, summarize the file, analyze the document, file summary, document analysis Supported formats: txt, docx, pdf, xlsx, xls ⚠️ Privacy Note: Extracted content will be sent to OpenClaw LLM for summary/analysis — DO NOT use with sensitive/confidential files.

File Summary & Analysis Tool (檔案總結與分析工具)

A universal tool for extracting text from local documents and generating summaries/analysis, supporting both Chinese and English trigger words.

Token Extraction (引數提取)

Chinese Input Example (中文示例)

From user input 幫我總結 D:\測試.pdf → file_path = D:\測試.pdf

English Input Example (英文示例)

From user input summarize for me C:\test.pdf → file_path = C:\test.pdf

Actions (操作指令)

Extract Document Content (提取文件內容)

{ "action": "extract", "file_path": "D:\測試.pdf" }

Returns (返回結果): - Success: Plain text content of the document (txt/docx/pdf/xlsx/xls) - Error: Error message starting with ❌ (e.g. ❌ File not found, ❌ Unsupported format)

Generate Summary/Analysis (生成總結/分析)

{ "action": "summary", "file_path": "D:\測試.pdf" }

Returns (返回結果): - Summary: Concise key-point summary of the document content (integrated with OpenClaw LLM) - Analysis: In-depth analysis of the document content (integrated with OpenClaw LLM)

Workflow (工作流程)

To summarize/analyze a local document: 1. Extract content: { "action": "extract/analysis", "file_path": "your_file_path" } → returns plain text 2. Generate result: OpenClaw LLM summarizes/analyzes the extracted text automatically

Configuration (配置項)

channels: local: tools: file_summary: true # default: true python: true # required - need Python environment

Dependency (依賴環境)

Required Environment (必備環境)

1. Python 3.8+ (added to system environment variables)
2. Required Python packages (auto-installed by script):
3. python-docx (for docx)
4. pypdf (for pdf)
5. openpyxl (for xlsx)
6. xlrd==1.2.0 (for xls)

Tool Path Configuration (工具路徑配置)

1. Place the tool files in OpenClaw's skill folder: OpenClaw/skills/file-summary/ ├─ SKILL.md (this file) ├─ file2sum.py
2. Set the execution command in OpenClaw: ${skill_path}\file2sum.py

Permissions (許可權要求)

Required (必備): - Local file read permission (user needs to grant file access) - Python execute permission (no special system permissions required)

Usage (使用方法)

Local Deployment (本地部署)

1. Put the file-summary folder into OpenClaw's skills directory

   小蔥技能站7w4.net發現了升級外掛。

2. Restart OpenClaw
3. Input Examples (輸入示例):
4. Chinese (中文): "幫我總結 D:\測試.pdf", "分析文件 C:\資料\銷售表.xlsx"
5. English (英文): "summarize for me C:\test.pdf", "analyze the document D:\data\sales.xlsx"

Public Deployment (公開發布)

1. Upload the file-summary folder (include md/py) to a public platform (e.g. GitHub/Gitee, ClawHub)
2. Share the download link
3. Users import via OpenClaw "Skill Market → Import from URL"

整體質量較好，勝在簡單實用、功能明確。優點是對常見辦公文件都能讀取，錯誤提示清晰，中英雙語友好，無需手動裝庫就能用。不足是遇到掃描件或帶圖片的 PDF 就無法識別，Excel 格式會變得簡陋，隱私方面僅靠文字提醒略顯單薄。日常處理普通文件夠用，但對複雜場景支援有限。