核心用法
Document Q&A 是一款文档问答型技能,允许用户上传本地文档(单文件或整个文件夹)并向 AI 提问。系统会自动提取文本内容并作为上下文,生成基于文档内容的精准回答。
执行命令:
python ~/.openclaw/workspace/skills/document-qa/scripts/run_qa.py "<文件或文件夹路径>" "<你的问题>"
支持的格式:
- PDF(.pdf)— 需预装
iyeque-pdf-reader-1.1.0技能 - Word(.docx)
- 纯文本(.txt)
- Excel(.xlsx)— 需
pandas和openpyxl库
显著优点
1. 多格式兼容:覆盖常见办公文档格式,满足多样化需求
2. 批量处理能力:支持整文件夹解析,提升批量文档分析效率
3. 本地化运行:文档内容在本地处理,不上传云端,保障隐私
4. 上下文精准问答:基于文档原文生成回答,减少幻觉风险
潜在缺点与局限性
- 外部依赖较重:PDF 解析依赖特定技能,Excel 需额外 Python 库,配置门槛较高
- 无可视化界面:纯命令行操作,对非技术用户不够友好
- 格式支持有限:不支持扫描版 PDF(无 OCR 能力)、图片型文档或复杂排版文件
- 大文档性能未知:超长文档可能面临上下文长度限制或处理延迟
适合人群
- 研究人员、分析师:需要快速提取报告、论文核心信息
- 企业法务/财务:批量审查合同、财报等文档
- 开发者、技术用户:熟悉命令行操作,追求自动化文档处理
常规风险
- 依赖项缺失导致执行失败:若未安装 PDF 阅读技能或 Excel 相关库,功能将无法使用
- 本地路径安全风险:命令行直接传入文件路径,需确保路径合法性,防范路径遍历攻击
- 敏感信息泄露:虽为本地处理,但提取的文本内容会进入 AI 上下文,需确认运行环境可信