name: file-summary description: | Local document summary tool. Activate when user mentions "總結檔案", "幫我總結", "總結文件", "分析文件" or provides a local file path (txt/docx/pdf/xlsx/xls).

File Summary Tool

Single tool file_summary for local document text extraction and summary.

Token Extraction

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

Actions

Extract Document Content

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

本技能來自小蔥技能站7w4.net。

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

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

Returns: Concise summary of the document content (integrated with OpenClaw LLM)

Workflow

To summarize a local document: 1. Extract content: { "action": "extract", "file_path": "your_file_path" } → returns plain text 2. Generate summary: OpenClaw LLM summarizes 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
2. Restart OpenClaw
3. User input example:
4. "幫我總結 D:\測試.pdf"
5. "總結檔案 D:\資料\銷售表.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"

這個工具質量中等偏上，勝在實用、配置簡單、能自動裝依賴庫，基本能滿足日常文件總結需求。但支援的格式偏少，大檔案沒限制，偶爾會遇到編碼問題，文件也沒有示例檔案方便新手快速上手。總體適合有明確文件格式需求的使用者使用。