这个技能是干啥的

一句话：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

翻译单个文件

translate --file ./docs/readme.md --lang en --out ./docs/readme_en.md

批量翻译（glob）

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

输出：
✓ article-1.md → article-1.md (en)
✓ article-2.md → article-2.md (en)
✓ 12 files translated in 18.3s

Provider 选择

translate-cli 支持多个 AI Provider，在 .openclaw/config.toml 里配置：

[translate]
default_provider = "openai"    # openai | anthropic | deepseek | gemini
default_model = "gpt-4o-mini" # 省钱首选

临时切换 Provider：

translate --provider anthropic --model claude-haiku "你好世界"
translate --provider deepseek "量子计算入门"

踩坑经验：用 DeepSeek 翻译中文技术文档效果最好，英文到中文的技术词汇处理比 GPT-4o 准确一些，而且便宜很多。但如果目标是英文，GPT-4o-mini 语感更自然。

预设配置（Presets）

这是 translate-cli 最强的功能，很多人没用到。你可以定义一个预设，包含语言对、模型、自定义 prompt 风格：

# 查看已有预设
translate presets list

创建预设
translate presets add tech-zh-to-en 
  --from zh 
  --to en 
  --provider openai 
  --model gpt-4o 
  --prompt "Translate the following Chinese technical content to English. Preserve all code blocks, technical terms, and markdown formatting exactly. Output only the translation."
使用预设
translate --preset tech-zh-to-en --file article.md

我们 SFD 实验室定义了三个核心预设：

• sfd-zh-to-en：中文技术文章→英文，保留代码块
• sfd-zh-to-tw：简体中文→繁体中文，技术词汇本地化
• sfd-product：产品文案翻译，保留 SEO 关键词结构

Dry-Run 验证

# 不实际翻译，只验证配置和文件路径
translate --preset sfd-zh-to-en --file "./content/*.md" --dry-run

输出：
[dry-run] Would translate 12 files
[dry-run] Provider: openai / gpt-4o
[dry-run] Estimated tokens: ~45,000
[dry-run] Estimated cost: ~$0.09

这个功能超级好用——在批量翻译大量文件前，先 dry-run 看看预计费用，避免意外账单。

TOML 配置文件

除了命令行参数，translate-cli 支持项目级配置文件 translate.config.toml：

[settings]
default_lang = "en"
concurrency = 3     # 并行翻译文件数
retry_on_fail = 2   # 失败重试次数
[presets.blog]
from = "zh"
to = "en"
provider = "anthropic"
model = "claude-haiku-3-5"
prompt_template = "./prompts/blog-translation.txt"
[output]
preserve_structure = true
append_lang_suffix = true  # article.md → article_en.md

踩坑记录

问题1：翻译后代码块被破坏

原因：默认 prompt 没有强调保留代码格式。解法：在预设的 prompt 里显式写「Preserve all <pre><code> blocks exactly as-is, do not translate code」。

问题2：繁体中文翻译出现简体词汇

原因：模型对「zh-TW」的理解不稳定，有时会混入大陆用词。解法：prompt 里加「Use Traditional Chinese (Taiwan standard). Do not use Simplified Chinese characters or Mainland China terminology.」

问题3：glob 批量翻译中途报错停止

原因：API 限流触发。解法：在 config.toml 里把 concurrency 从默认的5降到2，加上 retry_on_fail = 3。

问题4：大文件翻译超时

解法：对超过5000字的文章，先用 Summarize 技能分段，再翻译各段，最后合并。translate-cli 单次调用建议不超过3000词。

和其他技能的配合

• translate-cli + summarize：先摘要长文，再翻译摘要，比直接翻译全文省80%费用
• translate-cli + humanizer：翻译完的文章过一遍 humanizer 去AI味，特别适合博客内容
• translate-cli + smart-web-scraper：抓取外文网页→翻译→存为中文知识库

SFD编者注

我们 SFD 实验室目前用 translate-cli 做三件事：① 每天把中文文章翻译成英文和繁体，三语同步发布 smallfiredragon.com；② 小春蚕处理 BACAKU 内容时，把日文/英文资讯翻译成中文；③ 小猎鹰在审计外文安全文档时，先批量翻译成中文再分析。

一个月下来，这个技能帮我们省了大概每天30分钟的手动翻译时间。对内容驱动的项目来说，这个技能装了基本就不会卸载。