文件总结工具

单一工具 file_summary，用于本地文档文本提取与摘要生成。

令牌提取

用户输入 帮我总结 D:\测试.pdf → file_path = D:\测试.pdf

操作

提取文档内容

{ "action": "extract", "file_path": "D:\\测试.pdf" }

返回：

• 成功：文档的纯文本内容（支持 txt/docx/pdf/xlsx/xls 格式）
• 失败：以 ❌ 开头的错误信息（例如：❌ 文件未找到，❌ 不支持的格式）

生成摘要

{ "action": "summary", "file_path": "D:\\测试.pdf" }

返回：对文档内容的简洁摘要（集成 OpenClaw LLM 生成）

工作流程

要总结本地文档，请按以下步骤操作：

1. 提取内容：{ "action": "extract", "file_path": "your_file_path" } → 返回纯文本内容
2. 生成摘要：OpenClaw LLM 自动对提取出的文本进行摘要处理

配置

channels:
  local:
    tools:
      file_summary: true # 默认值：true
      python: true # 必需 - 需要 Python 环境

依赖项

必需环境

1. Python 3.8+（已添加至系统环境变量）
2. 所需 Python 包（脚本自动安装）：

- python-docx（用于 docx）

- pypdf（用于 pdf）

- openpyxl（用于 xlsx）

- xlrd==1.2.0（用于 xls）

工具路径配置

1. 将工具文件放入 OpenClaw 的技能目录中：

   OpenClaw/skills/file-summary/
   ├─ SKILL.md（此文件）
   ├─ file2sum.py

1. 在 OpenClaw 中设置执行命令：

${skill_path}\\file2sum.py

权限要求

必需权限：

• 本地文件读取权限（用户需授权访问文件）
• Python 执行权限（无需特殊系统权限）

使用方法

本地部署

1. 将 file-summary 文件夹放入 OpenClaw 的 skills 目录
2. 重启 OpenClaw
3. 用户输入示例：

- “帮我总结 D:\测试.pdf”

- “总结文件 D:\数据\销售表.xlsx”

公开部署

1. 将 file-summary 文件夹（含 md/py 文件）上传至公开平台（如 GitHub/Gitee、ClawHub）
2. 分享下载链接
3. 用户通过 OpenClaw “技能市场 → 从 URL 导入”功能导入