這個技能是幹啥的

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

預設配置（Presets）

# 建立預設
translate presets add tech-zh-to-en 
  --from zh --to en 
  --provider openai 
  --model gpt-4o 
  --prompt "翻譯中文技術內容到英文，保留所有程式碼區塊和格式"
使用預設
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分鐘的手動翻譯時間。