文档内容总结 Summary & Analysis txt/docx/pdf/xlsx/xls

local document summary & analysis tool. triggers: 帮我总结, 总结文件, 分析文档, 分析总结, 总结一下, 分析一下 summarize for me, analyze for me, summarize the file, analyze the docume...

Security Scan

The skill's code and instructions align with its stated purpose (extract local document text for downstream LLM summarization); there are no hidden network endpoints or unrelated credential requests, but it auto-installs Python packages at runtime which has predictable risks you should understand.

Purpose & Capability

The name/description, SKILL.md, and file2sum.py all describe the same capability: extract text from local txt/docx/pdf/xlsx/xls files and hand the text to the OpenClaw LLM for summary/analysis. Required capabilities and files are proportional to that purpose.

Instruction Scope

Runtime instructions and the script only read a single user-specified local file path and print its text (or an error starting with ❌). The SKILL.md explicitly warns that extracted content is sent to the OpenClaw LLM; the code itself does not contact external endpoints. The instructions do not request unrelated files, credentials, or system configuration.

Install Mechanism

There is no packaged install spec, but the script will auto-install required Python packages at runtime using pip (subprocess.check_call). This pulls packages from PyPI over the network and runs their install-time code; while expected for a Python-based document reader, it is a moderate operational risk (modifies environment, network access, potential arbitrary code execution during package installation).

Credentials

The skill declares no environment variables, no credentials, and no config paths. The script only requires a Python runtime and will install standard parsing libs (python-docx, pypdf, openpyxl, xlrd==1.2.0). These requirements are proportionate to the stated purpose.

Persistence & Privilege

The skill does not request always:true, does not modify other skills, and does not write persistent system-wide configuration. It only prints extracted content for the host agent to consume.

Assessment

This skill appears to do what it claims: extract file text and let OpenClaw LLM summarize it. Before installing/using it: 1) Do not feed sensitive or confidential documents (SKILL.md already warns that extracted content goes to the LLM). 2) Run it in a controlled Python environment (virtualenv/container) because the script auto-installs packages from PyPI at runtime; installation scripts can execute code and will modify the environment. 3) Review the few package names it installs (python-docx, pypdf, openpyxl, xlrd==1.2.0) and consider installing them yourself ahead of time to avoid automatic runtime installs. 4) If you need stricter privacy, inspect OpenClaw's export/telemetry policy to confirm where stdout is sent, or run the script locally and keep summaries offline. 5) If you want additional assurance, run the script on non-sensitive sample files first and inspect network activity during pip installs.

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" } { "action": "extract", "file_path": "C:\test.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" } { "action": "analysis", "file_path": "C:\test.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):
   • python-docx (for docx)
   • pypdf (for pdf)
   • openpyxl (for xlsx)
   • 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. Input Examples (输入示例):
   • Chinese (中文): "帮我总结 D:\测试.pdf", "分析文档 C:\数据\销售表.xlsx"
   • 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"