这个技能是干啥的

一句话：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分钟的手动翻譯时间。对內容驱动的專案来说，这个技能装了基本就不会卸载。