QClaw通过原生API监听文件夹变更并触发自动化任务：启用内置监听器、绑定微信指令调用Skill、用EventRuleEngine配置高级规则，最后通过开发者工具实时验证事件捕获。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望QClaw在特定文件夹中检测到新文件、修改或删除操作时自动执行对应任务，则需依赖其底层文件系统监听机制与事件驱动能力。以下是实现该功能的具体操作路径：
一、启用QClaw内置文件监听器（Windows/macOS通用）
QClaw通过调用操作系统原生文件监控API（如Windows的ReadDirectoryChangesW、macOS的FSEvents）实现实时感知目录变更，无需额外安装服务，但需确保QClaw拥有对应文件夹的读取与监视权限。
1、打开QClaw主界面，点击左下角「设置」图标。
2、进入「自动化」选项卡，找到「文件夹监听」模块。
3、点击「添加监听路径」，在弹出窗口中选择目标文件夹（例如：D:\Invoice\Incoming 或 ~/Downloads/Receipts）。
4、勾选需响应的事件类型：创建、修改、重命名、删除（可多选）。
5、点击「保存并启用」，QClaw将立即启动后台监听进程，并在状态栏显示「监听中」绿色指示灯。
二、绑定自然语言指令触发动作
监听器本身不执行逻辑，仅捕获事件；真正响应行为由用户预设的微信指令模板驱动。QClaw将事件元数据（如文件名、路径、时间戳、MIME类型）注入大模型上下文，解析意图后调用对应Skill。
1、在微信中向「龙虾」好友发送指令：当D盘Invoice文件夹有新PDF文件时，自动提取发票信息并存为Excel。
2、QClaw识别出「文件夹监听+OCR+表格生成」组合意图，自动关联ClawHub中已启用的「InvoiceParser」Skill。
3、收到首份新PDF后，QClaw弹出桌面授权请求，确认后启动本地OCR引擎，完成结构化数据抽取。
4、生成的Excel文件自动保存至同级目录下的「Processed」子文件夹，并通过微信推送通知及文件卡片。
多模态论文可视化引擎，自动从 PDF 或纯文本生成学术插图，支持全篇扫描识别可图化内容、双编码器架构图/算法流程图/动机图生成、自校核、LaTeX/Word 图注输出、Matplotlib 精确绘图，并提供独立 PDF→Text 提取工具。
三、通过ClawHub手动配置事件规则（高级模式）
对于需精确控制触发条件（如仅响应特定前缀文件、跳过临时文件、按大小阈值过滤）的场景，可使用ClawHub技能市场中的「EventRuleEngine」进行可视化规则编排，所有规则均在本地运行，不上传原始文件内容。
1、在QClaw设置页点击「技能市场」，搜索并安装「EventRuleEngine」。
2、重启QClaw后，在「自动化」→「高级规则」中打开该技能界面。
3、点击「新建规则」，填写名称（例：_ReceiptAutoTag_），选择监听路径与事件类型。
4、在「匹配条件」区域设置：文件扩展名 = .pdf 且 文件名包含 "receipt" 且 文件大小 > 10KB。
5、在「执行动作」区域选择预置动作「调用Skill：TagAndArchive」，并指定归档路径为「~/Documents/Archived/Receipts」。
四、验证监听是否生效（实时反馈）
QClaw提供即时调试通道，可在不依赖微信消息的前提下直接观测监听器运行状态与事件捕获日志，避免因网络延迟或消息未送达导致误判。
1、在QClaw主界面右上角点击「开发者工具」按钮（齿轮图标旁的符号）。
2、切换至「事件流」标签页，确保右上角「监听器状态」显示为活跃。
3、在目标文件夹内新建一个测试文件（如test_trigger.txt），观察事件流窗口是否在1秒内刷新出带时间戳的条目，含字段：event=created, path=.../test_trigger.txt, timestamp=2026-03-12T09:08:22。
4、若无刷新，点击「诊断」按钮，查看错误提示（常见为权限拒绝或路径被其他进程独占锁定）。
