qclaw支持四种批量处理文档任务的方法：一、用模板+csv批量创建；二、通过cli命令行批量执行；三、利用webhook自动分发子任务；四、按标签筛选后批量启停或删除任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在QClaw中一次性完成多个文档类任务（如批量生成报告、统一润色Word、同步更新多份腾讯文档），而非逐一手动打开与操作，则需调用其内置的批量处理机制。以下是实现QClaw批量处理多个文档任务的具体方法：
一、使用模板+CSV批量创建文档任务
通过预设标准化文档处理模板，可一次性生成结构一致的多个文档任务，避免重复配置参数。模板支持变量占位符，适配不同目标文件路径、格式要求或内容指令。
1、进入QClaw主界面，点击左侧导航栏中的“模板管理”。
2、点击右上角“新建模板”按钮，填写模板名称并选择任务类型为“文档处理”。
3、在模板编辑区配置通用字段（如目标文件夹路径、输出格式、AI模型选择），并在需差异化字段处插入变量，例如${input_file}或${output_prefix}。
4、保存模板后，在“批量创建”页面选择该模板，上传CSV文件，其中每行对应一个文档任务实例，变量将按列自动替换并触发执行。
二、通过CLI命令行批量执行文档任务
QClaw CLI工具允许绕过图形界面，直接调用本地文档处理引擎执行已定义的多个文档任务，适合集成到定时脚本或办公自动化流程中。
1、确保已安装QClaw CLI，并运行qclaw-cli login完成身份认证。
2、将待处理文档的绝对路径列表保存为纯文本文件，每行一个路径，命名为docs_to_process.txt。
3、执行命令：qclaw-cli batch run --task-type doc --file-list docs_to_process.txt --concurrency 3，其中--concurrency控制并发处理文档数。
4、CLI将返回每个文档任务的初始状态码及分配的处理节点ID，日志输出至当前目录下的batch_doc_YYYYMMDD.log。
三、利用Webhook接收JSON请求自动分发文档子任务
当文档处理需求来自外部系统（如企业微信审批流、腾讯文档变更通知或OA系统事件）时，可通过QClaw开放的Webhook端点接收结构化请求，自动解析并分发为多个独立文档任务。
1、在QClaw设置中启用“Webhook接收器”，获取专属签名密钥与回调URL。
2、向该URL发送POST请求，Body为JSON格式，包含字段：{"batch_id": "DOC20260515", "items": [{"file_path": "/Users/me/Desktop/报告A.docx", "action": "summarize"}, {"file_path": "/Users/me/Desktop/合同B.pdf", "action": "extract_clauses"}]}。
3、QClaw接收到请求后，自动校验HMAC-SHA256签名，验证通过则为每个items元素生成独立文档任务，并绑定统一batch_id标签。
4、所有子任务状态可通过/api/v1/batch/DOC20260515/status接口实时查询，响应中包含各子任务的id、state、start_time字段。
四、按标签筛选后批量启停或删除文档任务
对于已创建但尚未执行的文档类任务，可通过标签快速归集并统一调度。QClaw支持对带有相同标签（如“Q3财报”“会议纪要”“客户交付”）的任务进行批量启停或清理，避免无效占用资源。
1、在QClaw任务列表页，点击顶部“筛选”按钮，选择“标签”条件，输入会议纪要。
2、勾选全部显示的任务条目，点击右上角“批量操作”下拉菜单。
3、选择“批量启动”，系统将立即触发所有标记为“会议纪要”的文档生成与格式化任务。
4、若需暂停后续处理，可再次筛选该标签，改选“批量停止”，所有运行中任务将转入暂停状态，进度保留不丢失。
