translate-cli 实战指南：一条命令搞定多语言翻译、文件批量处理与 preset 配置

这个技能是干啥的

一句话：translate-cli 是 OpenClaw 生态里最被低估的生产力技能。它让你用一条命令翻译任意文本、stdin 流、单个文件或整个目录的 glob 文件——支持多个 AI Provider 切换、preset 配置、自定义 prompt 模板，还能 dry-run 校验。

我们 SFD 实验室用它每天批量翻译文章到英文和繁体中文，三语发布 smallfiredragon.com，替掉了一堆手动复制粘贴的操作。

安装

clawhub install translate-cli

装完验证：

translate --version
# translate-cli v1.x.x

基础用法

翻译文本

# 直接翻译文本
translate "深度学习入门指南"

# 指定目标语言
translate --lang en "深度学习入门指南"
# → Introduction to Deep Learning

stdin 输入

# 管道传入
echo "上下文窗口技术" | translate --lang en

# 从文件读取
cat article.txt | translate --lang zh-TW > article_tw.txt

批量翻译（glob）

# 翻译整个目录的 markdown 文件
translate --file "./content/*.md" --lang en --out-dir ./content_en/

# 输出：
# ✓ 12 files translated in 18.3s

preset 配置

# 创建 preset
translate presets add tech-zh-to-en \
  --from zh --to en \
  --provider openai \
  --model gpt-4o \
  --prompt "翻译中文技术内容到英文，保留所有代码块和格式"

# 使用 preset
translate --preset tech-zh-to-en --file article.md

Dry-Run 校验

translate --preset sfd-zh-to-en --file "./content/*.md" --dry-run
# [dry-run] Would translate 12 files
# [dry-run] Estimated cost: ~$0.09

踩坑记录

繁体中文混进简体词汇：在 prompt 里加 “Use Traditional Chinese (Taiwan standard)”
批量翻译中途停止：API 限流，把 concurrency 降到 2，加 retry_on_fail = 3
代码块被翻译：prompt 里明确写 “Preserve all code blocks exactly as-is”

与其他技能搭配

translate-cli + summarize：先摘要长文再翻译，省 80% 费用
translate-cli + humanizer：翻译完过一遍去 AI 味，适合博客内容

SFD 编者注

我们 SFD 实验室目前用 translate-cli 做三件事：① 每天把中文文章翻译成英文和繁体，三语同步发布；② 小春蚕处理 BACAKU 内容时，把日文/英文信息翻译成中文；③ 小猎鹰审计外文安全文档时，先批量翻译再分析。一个月下来省了每天约 30 分钟的人工翻译时间。