应启用QClaw的文档变量替换与批量渲染能力：一、用文档技能插件绑定模板并映射CSV字段生成PDF；二、通过CLI命令行高并发批量渲染；三、在工作流中配置定时触发、条件分支与邮件分发的自动化任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您拥有统一格式的合同模板与结构化客户信息数据，但需逐一手动填充生成多份合同，则可能是由于未启用QClaw的文档变量替换与批量渲染能力。以下是实现合同模板批量填充和变量替换的多种方法：
一、使用QClaw文档技能插件绑定合同模板并执行变量替换
该方法通过上传本地Word或Markdown格式的合同模板，在其中预设变量占位符，QClaw将依据CSV或数据库字段自动注入对应值，适用于中小批量（数十至数百份）且需保留原排版的场景。
1、进入QClaw左侧导航栏，点击“技能中心” → “文档生成”。
2、点击“新建模板”按钮，上传已编辑好的合同模板文件（.docx或.md），确保所有需动态填充位置已替换为形如{{client_name}}、{{contract_amount}}、{{sign_date}}的双大括号变量。
3、在模板编辑页中，点击“字段映射”按钮，将每个变量手动关联至数据源列名；支持从CSV文件导入字段定义，或选择已配置的本地变量集。
4、保存模板后，在指令栏输入/use-template 合同_标准版_v3，并附加参数--data-source clients_q2.csv，系统将按行读取CSV并逐份生成填充后的合同PDF。
二、通过CLI命令行调用QClaw批量渲染合同文档
该方法绕过图形界面，直接调用QClaw本地文档引擎执行高并发批量填充任务，适合集成至法务/销售自动化流程，支持千级合同量及自定义输出路径。
1、确认已安装QClaw CLI工具，并执行qclaw-cli login完成身份认证。
2、准备两份文件：一份为含变量占位符的.docx合同模板（如contract_template.docx），另一份为UTF-8编码的CSV数据文件（如clients.csv），首行为字段头，例如client_name,contract_amount,sign_date。
3、执行命令：qclaw-cli doc render --template contract_template.docx --data clients.csv --output-dir ./generated_contracts --concurrency 5。
4、运行完成后，./generated_contracts目录下将生成与CSV行数一致的独立合同文件，文件名默认为“合同_序号.pdf”，可使用--filename-pattern参数自定义命名规则。
三、在QClaw工作流中配置自动化合同生成任务
该方法将合同填充嵌入可视化自动化流程，支持定时触发、条件分支与结果分发，适用于需定期向不同客户群推送定制化合同的运营或签约场景。
1、进入“自动化” → “新建流程”，选择触发器类型为“手动启动”或“每日上午10:00”。
2、添加“数据源”节点，选择CSV文件路径或连接内部数据库表，设置筛选条件如status = 'pending_sign'。
3、添加“文档渲染”节点，选择已绑定的合同模板，并将上一节点输出字段拖拽至对应变量映射框内。
4、添加“文件分发”节点，勾选“按client_email发送邮件”，附件选择渲染结果，邮件正文可插入{{client_name}}实现个性化问候。
