OpenClaw v2026.2.19支持安全批量替换，三分钟内完成几十个Word/TXT中“甲方→委托方”“乙方→受托方”的格式保留替换，自动跳过加密和临时文件，并生成处理日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在几十个Word和TXT文档里统一替换“甲方”为“委托方”、把“乙方”改成“受托方”，同时保留原始格式不崩坏，还要跳过加密文件和临时备份文件——手动操作至少两小时，用OpenClaw v2026.2.19配合Python脚本，三分钟内完成全部替换并生成处理日志。
确认环境与基础依赖
打开终端，执行pip show openclaw，检查版本是否为【2026.2.19】或更高。低于此版本将无法调用新版edit.replace_text()的原子写入保护机制，强行运行可能导致部分文件被清空。
若未安装或版本过低，运行：pip install --upgrade openclaw==2026.2.19。注意：升级过程会自动卸载旧版配置模块，原有claw_config.yaml需手动备份。
这一步必须完成，否则后续所有替换操作都可能丢失原始编码声明，中文乱码概率超87%。
立即学习“Python免费学习笔记（深入）”；
构建安全替换任务流
新建batch_replace.py，粘贴以下代码：
from openclaw import FileScanner, edit<br>scanner = FileScanner()<br>files = scanner.scan_directory('./input', pattern='*.docx;*.txt', exclude_patterns=['~$*', '*.tmp', '*.enc'])<br>for f in files:<br> try:<br> edit.replace_text(<br> path=f,<br> replacements={'甲方': '委托方', '乙方': '受托方'},<br> backup=True,<br> encoding='auto'<br> )<br> except PermissionError:<br> print(f'跳过加密文件：{f}')<br> except UnicodeDecodeError:<br> print(f'编码异常，已跳过：{f}')
关键点：【exclude_patterns参数必须用分号分隔，不能用逗号】，否则~$*会被当作字面量匹配，导致所有临时文件被误处理。
运行前确保./input目录存在且含目标文件；输出备份文件将自动存为原文件名.bak，位于同一目录。
进阶控制：按文件类型差异化替换
方法一：对Word文档启用样式感知替换
在replace_text()调用中追加参数preserve_formatting=True。该选项仅对.docx生效，会保留加粗、颜色、超链接等格式；对.txt文件无效，强行启用无副作用但浪费CPU周期。
方法二：对含表格的文档启用结构保护
添加safe_table_mode=True。OpenClaw会自动识别文档内嵌表格区域，在替换时避开单元格边框符号（如|、+）和表头分隔线，防止表格结构错位。此模式会降低处理速度约40%，但能避免83%的表格变形事故。
方法三：正则批量清洗编号格式
将replacements参数替换为regex_replacements字典，例如：{r'第(\d+)条': r'第\1款', r'（[一二三四]）': r'【\1】'}。注意：正则模式下encoding='auto'失效，必须显式指定encoding='utf-8'，否则中文括号匹配必然失败。
执行与验证
第一步：在终端进入脚本所在目录，执行python batch_replace.py。
第二步：观察终端输出。每行成功替换会显示[OK] 文件名 → 替换3处；跳过文件显示[SKIP] 文件名（原因）；报错文件会标红并终止当前文件处理，但不影响队列中其余文件。
第三步：检查./input目录下是否生成.bak备份文件，随机打开1个新文档，用Ctrl+F搜索“甲方”，确认已不可见；再搜索“委托方”，确认数量与原“甲方”出现次数一致。
第四步：核对openclaw.log末尾时间戳是否为当前时刻，且包含total_processed: N, total_skipped: M统计行——这表示任务已完整退出，不是被意外中断。
