前言¶
把會議錄音、採訪素材或配音草稿轉成可編輯文本，常見做法是接雲端語音識別 API：要申請密鑰、按量計費，還要把音頻上傳到第三方。若你已經在本機安裝 OpenAI 的 Whisper 命令行工具，更希望 Agent 按固定流程調用 whisper、在本地完成轉寫，可以藉助 SkillHub 上的 Openai Whisper（座標 @clawhub_steipete/openai-whisper）。該 Skill 標明 requires_api_key=false，核心是指導 Agent 使用 Whisper CLI，而不是封裝付費接口。
這是什麼¶
Openai Whisper 是一條基於通用 SKILL.md 格式的 Agent Skill：一句話定位是「使用 Whisper CLI 進行本地語音轉文字（無需 API 密鑰）」。內容來自 ClawHub 上游 steipete/openai-whisper，由發佈者 steipete（ClawHub 頁顯示爲 Peter Steinberger）維護，在 SkillHub 上歸類爲 design-media，版本 1.0.0。國內可通過 SkillHub 技能頁與鏡像入口安裝；官方聚合地址爲 https://api.skillhub.cn/zcwl/openai-whisper，對應 SkillHub 展示頁爲 https://www.skillhub.cn/skills/clawhub_steipete/openai-whisper。
核心功能¶
以下能力均來自上游 Skill 說明與 ClawHub 頁面，不含額外推斷：
- 本地轉寫：通過
whisper命令處理本地音頻文件，輸出文本或字幕等格式。 - 無需 API Key：Skill 標籤爲
requires_api_key=false，不依賴雲端語音識別密鑰。 - 可配置模型與任務：支持
--model選擇模型體量；支持--task translate等 Whisper CLI 自帶參數。 - 首次運行自動拉取模型：模型緩存目錄爲
~/.cache/whisper（上游 Notes 說明）。
安裝與啓用¶
通過 SkillHub CLI（推薦在國內環境）¶
先確認是否已安裝 skillhub（完整步驟見 SkillHub 安裝文檔）：
command -v skillhub && skillhub --version
未安裝時可執行文檔中的安裝腳本。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。Cursor 的 skills 目錄一般爲 ~/.cursor/skills/（其他客戶端路徑以 SkillHub 文檔第四節爲準）。
skillhub install @clawhub_steipete/openai-whisper --dir ~/.cursor/skills/
也可讓 AI 按 SkillHub 頁面提示，依據 https://skillhub.cn/install/skillhub.md 安裝 @clawhub_steipete/openai-whisper。
通過 ClawHub / OpenClaw 上游¶
若使用 OpenClaw 生態，上游給出的安裝方式爲：
openclaw skills install @steipete/openai-whisper
安裝 Skill 只解決「Agent 知道怎麼調用」；本機仍需已安裝可用的 whisper CLI（Whisper 本體不在 Skill 包內替代安裝）。
典型用法¶
啓用 Skill 後，Agent 會按文檔引導你執行 Whisper CLI。上游 Quick start 示例如下。
轉寫爲純文本（指定 medium 模型，輸出到當前目錄）：
whisper /path/audio.mp3 --model medium --output_format txt --output_dir .
翻譯任務並生成 SRT 字幕：
whisper /path/audio.m4a --task translate --output_format srt
使用注意（來自上游 Notes）：
- 首次運行會從網絡下載模型到
~/.cache/whisper。 - 該安裝環境下
--model默認值爲turbo；更小模型更快，更大模型通常更準確。
適用場景與注意¶
適合誰：需要在創意設計、媒體制作等流程裏把本地音頻轉成文字或字幕、且希望 Agent 統一給出命令與參數說明的開發者；分類爲 design-media，與音視頻素材處理場景一致。
限制與前提：
- 依賴本機 Whisper CLI 與算力；長音頻、大模型對 CPU/GPU 和磁盤佔用明顯，上游未承諾特定硬件指標。
- Skill 提供的是調用規範與示例，不代替你自行處理音頻版權、隱私與合規（本地處理可降低外傳風險，但仍需自行評估）。
- SkillHub 列表數據（如評分、下載量）會隨時間變化；查閱時以技能頁實時展示爲準。
結尾¶
Openai Whisper 把「本地 whisper 轉寫」固化成 Agent 可複用的 Skill：無 API Key、命令與參數與上游一致，適合在 Cursor 等客戶端裏做語音素材的文字化。安裝與詳情見 SkillHub：https://www.skillhub.cn/skills/clawhub_steipete/openai-whisper；鏡像入口：https://api.skillhub.cn/zcwl/openai-whisper。
