\r \r

File Summary & Analysis Tool (文件总结与分析工具)\r

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

Token Extraction (参数提取)\r

\r

Chinese Input Example (中文示例)\r

From user input 帮我总结 D:\测试.pdf → file_path = D:\测试.pdf\r \r

English Input Example (英文示例)\r

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

Actions (操作指令)\r

\r

Extract Document Content (提取文档内容)\r

{ "action": "extract", "file_path": "D:\测试.pdf" }\r { "action": "extract", "file_path": "C:\ est.pdf" }\r \r Returns (返回结果):\r

• Success: Plain text content of the document (txt/docx/pdf/xlsx/xls)\r
• Error: Error message starting with ❌ (e.g. ❌ File not found, ❌ Unsupported format)\r \r

Generate Summary/Analysis (生成总结/分析)\r

{ "action": "summary", "file_path": "D:\测试.pdf" }\r { "action": "analysis", "file_path": "C:\ est.pdf" }\r \r Returns (返回结果):\r

• Summary: Concise key-point summary of the document content (integrated with OpenClaw LLM)\r
• Analysis: In-depth analysis of the document content (integrated with OpenClaw LLM)\r \r

Workflow (工作流程)\r

\r To summarize/analyze a local document:\r

1. Extract content: { "action": "extract/analysis", "file_path": "your_file_path" } → returns plain text\r
2. Generate result: OpenClaw LLM summarizes/analyzes the extracted text automatically\r \r

Configuration (配置项)\r

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

Dependency (依赖环境)\r

\r

Required Environment (必备环境)\r

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

Tool Path Configuration (工具路径配置)\r

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

Permissions (权限要求)\r

\r Required (必备):\r

• Local file read permission (user needs to grant file access)\r
• Python execute permission (no special system permissions required)\r \r

Usage (使用方法)\r

\r

Local Deployment (本地部署)\r

1. Put the file-summary folder into OpenClaw's skills directory\r
2. Restart OpenClaw\r
3. Input Examples (输入示例):\r
   • Chinese (中文): "帮我总结 D:\测试.pdf", "分析文档 C:\数据\销售表.xlsx"\r
   • English (英文): "summarize for me C: est.pdf", "analyze the document D:\data\sales.xlsx"\r \r

Public Deployment (公开发布)\r

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