本篇以 macOS Apple Silicon（ARM）為示範環境，實測設備為 MacBook Pro M4 Pro。部署流程採用穩定且容易排錯的順序：先建立標準化系統環境，再安裝執行框架，最後完成 ChatGPT 訂閱驗證與 Codex 模型連線。

目標不是只完成安裝，而是建立一套可長期運作的 AI 代理環境。

先確認你的 Mac 是否為 Apple Silicon（ARM）

如果你的 Mac 是 M1、M2、M3 或 M4 系列晶片，基本上就是 ARM 架構。可以在終端機輸入：

uname -m

若顯示 arm64，代表是 Apple Silicon。

這個確認動作看似簡單，但很重要。Homebrew 在 ARM 與 Intel 架構上的安裝路徑不同，後續 Node 與 OpenClaw 也會依照架構選擇對應版本。從正確的系統架構開始，可以避免後續相容性問題。

第一步：安裝 Homebrew

如果尚未安裝 Homebrew，可使用官方指令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

初次安裝時，系統可能會自動安裝 Command Line Tools for Xcode。這是 macOS 提供的基礎開發工具，包含編譯器與必要的系統函式庫，許多套件（包含 Homebrew 與 Node.js）都依賴這些工具才能正常編譯與執行。此步驟可能需要一些時間，請耐心等待完成後再繼續。

完成後載入環境變數：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

這一步是把 Homebrew 的安裝路徑加入系統的 PATH 環境變數，讓 macOS 知道 brew 指令的位置。否則即使安裝完成，終端機仍然無法使用 brew。

為什麼從 Homebrew 開始？

Homebrew 是 macOS 上最成熟的套件管理工具。透過它安裝 Node.js，可以確保版本一致、依賴完整，也能避免常見的權限與 PATH 錯誤。

對於後續部署來說，Homebrew 是整個系統的基礎層。基礎層穩定，後續的代理與模型才會穩定。

第二步：安裝 Node.js

OpenClaw 是基於 Node.js 執行，因此必須先建立 Node 環境。建議版本為 22 以上。

直接透過 Homebrew 安裝：

brew install node

為什麼 Node 版本重要？

新版 OpenClaw 依賴較新的 Node API 與模組管理機制。如果版本過舊，可能會出現模組錯誤或服務啟動失敗的情況。

這一步的意義不只是「裝好 Node」，而是確保整個執行框架符合現行標準。

第三步：安裝 OpenClaw（CLI 版本）

有了 Node 環境後，就可以安裝 OpenClaw。

建議使用官方 CLI 安裝方式：

curl -fsSL https://openclaw.ai/install.sh | bash

為什麼建議使用 CLI，而不是 brew GUI 版本？

CLI 版本是 OpenClaw 的核心實作層，結構單純、行為清晰，也最容易排錯。部分透過 brew 安裝的 GUI 或封裝版本，可能會與背景服務重複啟動，導致：

• Gateway 重複執行
• 使用不同設定檔路徑
• Port 被佔用

從架構角度來看，CLI 是核心層，GUI 只是操作層。先掌握核心層，系統穩定性會更高。

即使使用 CLI 安裝，最終仍然可以透過瀏覽器開啟 Web Chat 介面進行對話與管理，因此不會失去圖形化操作的便利性。

第四步：連接 ChatGPT 訂閱並使用 Codex 模型

安裝完成後，OpenClaw 需要連接到你的 ChatGPT 訂閱，才能真正驅動模型。

建議透過 auth 驗證方式登入，而不是手動貼上 API Key。透過 auth，可以直接使用你目前登入 ChatGPT 帳戶的訂閱權限與可用模型。

在互動式流程中選擇：

• AI 提供者（例如 OpenAI）
• 使用 auth 登入驗證
• 選擇可用的 Codex 模型，例如 openai-codex/gpt-5.3-codex

關於訂閱與使用成本

ChatGPT Plus 訂閱每月 20 美元。透過 auth 連接後，OpenClaw 就能直接使用該訂閱下可用的模型權限，包括 Codex 類型模型。

對於一般開發、指令生成與自動化操作而言，Plus 訂閱提供的資源通常足以應付日常使用，不需要額外管理 API 計費或自行控制 token 使用量。對個人開發者或進階使用者來說，這是一個結構簡單且成本可預期的方案。

為什麼選擇 Codex 模型？

Codex 模型在程式碼理解與 CLI 操作方面具備更好的穩定性與精準度。當 OpenClaw 作為本機代理使用時，這類模型特別適合處理：

• 指令生成
• 自動化腳本
• 節點管理
• 技術流程操作

完成這一步後，OpenClaw 就能正式以你的 ChatGPT 訂閱作為後端模型來源。若想查看模型使用情況與額度，可前往 https://chatgpt.com/codex/settings/usage 確認當前用量與紀錄。

第五步：啟動 Gateway 並開啟 Web Chat

Gateway 是 OpenClaw 的核心服務，負責接收指令、轉發給模型並管理代理狀態。

啟動服務：

openclaw gateway start

然後在瀏覽器開啟：

http://127.0.0.1:18789/

只要 Web Chat 能正常回應，代表整個代理系統已成功運作。

到這一步，其實就可以開始實際操作。建議先請它自我介紹，或請它協助檢查目前系統狀態，確認模型是否正常連線、Gateway 是否穩定運作，透過簡單互動測試整體環境是否建置完成。

部署完成後可以做什麼？

完成上述流程後，系統已建立一套可在本機背景常駐運作的 AI 代理環境。後續多數設定與操作，都可以直接透過 Web Chat 介面完成，而不必頻繁回到 CLI 指令列。

後續可以進一步：

• 新增 Node 節點（讓 OpenClaw 在電腦上持續執行並接收任務）
• 安裝與管理 Skills（擴充功能模組，增加搜尋或資料處理能力）
• 串接 Telegram（建立 AI 對話與自動回覆）
• 串接 WhatsApp（應用於客服或自動化聊天場景）
• 調整模型與權限設定（切換模型或限制可執行範圍）

無論是安裝與管理 Skills、串接 Telegram 或 WhatsApp，甚至調整模型與權限設定，都可以直接請 OpenClaw 說明步驟並引導設定。當模型與 Gateway 已正常運作後，實際操作本身就是最好的教學，接下來已不太需要依賴逐步指令型教學文件。

讓 ChatGPT 成為可執行的本機代理

若希望日後更方便存取對話介面，可直接在瀏覽器開啟 http://127.0.0.1:18789/chat，並將該頁面儲存為桌面應用程式。

以 Chrome 為例，可點選右上角「自訂與管理」選單，選擇「投放、儲存及分享」→「建立應用程式」，將 OpenClaw 儲存為網頁應用程式。完成後，它會以獨立視窗形式開啟，並可固定於 Dock 上，之後只需點擊圖示即可直接進入對話介面。

重要提醒

如果你是透過 ChatGPT、Gemini 或其他 AI 工具閱讀本文，請留意轉述或摘要過程中，安裝步驟與技術細節可能被簡化、重組，甚至產生與原文不同的解讀。由於系統環境與版本差異會直接影響部署結果，建議回到原始來源閱讀完整內容，並再次確認你的 Mac 硬體架構（例如是否為 Apple Silicon）以及 macOS、Node.js 等版本是否相符。

本站另提供 1:1 付費諮詢服務，可協助 macOS 安裝與設定。歡迎透過 LINE 官方帳號 聯繫。

不過，這些影片仍未內嵌時間與日期資訊，若要作為行車糾紛或交通檢舉的佐證，通常仍需搭配其他工具輔助。先前介紹過的 Sentry Viewer，雖然提供時間浮水印與片段合併等功能，但目前已自 App Store 下架。本文將改為推薦使用開源專案《tesla_dashcam》，提供更穩定的影片管理與轉檔方式，較能符合多數特斯拉車主的使用需求。

本文將以 macOS 15.5 作為示範環境，實際上 tesla_dashcam 可在 macOS、Windows 與 Linux 系統上執行，只需安裝 Python 3.7 以上版本與 ffmpeg，即可正常運作。

所需工具與安裝說明

• tesla_dashcam：將 Tesla 錄影畫面合成並加上時間浮水印的命令列工具
• pipx：用來安裝 tesla_dashcam 的 Python 工具管理器
• FFmpeg：影片處理工具，由 tesla_dashcam 呼叫使用
• TeslaCam 檢視器：免安裝網頁工具，可預覽並篩選想要的哨兵影片

1. 安裝 Homebrew（若尚未安裝）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安裝 FFmpeg 與 pipx

brew install ffmpeg pipx
pipx ensurepath

執行完 pipx ensurepath 後請重新打開終端機，或執行：

source ~/.zshrc

3. 安裝 tesla_dashcam

pipx install tesla_dashcam

完成後確認是否安裝成功：

tesla_dashcam --help

為什麼不直接用 pip 安裝？macOS 的 PEP 668 限制

在 macOS 上，若透過 Homebrew 安裝 Python，系統會啟用 PEP 668，限制使用 pip 安裝全域套件，以避免影響系統或其他工具。若直接執行 python3 -m pip install tesla_dashcam，將會出現 error: externally-managed-environment 錯誤。建議改用 pipx 安裝，讓 tesla_dashcam 運作於獨立環境中，更穩定也更不易與其他套件衝突。

建議先預覽影片片段再轉檔

由於哨兵模式的錄影會將每個事件分割成多個 1 分鐘的片段，若直接轉出整個資料夾，將耗費大量時間與電腦資源。因此，建議先使用 TESLAGURU 推出的免費工具「TeslaCam 哨兵行車記錄器檢視器」，快速預覽各段影片內容與時間，篩選所需片段後再進行轉出，可大幅提升效率，並避免不必要的轉檔作業。

此工具支援直接瀏覽 Tesla USB 裡的影片資料夾，提供四鏡頭同步播放與鍵盤控制功能，並可自訂篩選特定日期、片段或時間點，使用上無需下載其他資源，亦可在離線環境中順利運作。

找出需要的片段後，將想轉檔的影片（如 2025-05-30_15-00-28-front.mp4）複製到電腦中的 Downloads/input 資料夾。

建立輸入與輸出資料夾

在進行影片轉檔之前，建議先在 macOS 預設的「下載項目」（Downloads）資料夾中建立兩個臨時資料夾，一個用來放入需要加上時間標籤的影片，另一個作為轉出影片的儲存位置。可透過以下指令快速建立：

mkdir -p ~/Downloads/input ~/Downloads/output

其中，input 資料夾用來放置你從 TeslaCam 中挑選出來、準備加上時間戳記的影片片段；output 資料夾則會儲存轉出後的新影片。你也可以依照個人需求，自行修改這兩個資料夾的名稱與路徑，例如改放在桌面或其他指定的工作目錄，只要後續指令中的路徑一致即可。這樣的做法能協助檔案清楚分類，避免混淆或檔案被覆蓋的情況發生。

輸出影片並加上時間標籤

選定好輸入與輸出資料夾後，就可以開始進行影片轉檔並加上時間標籤。你可以依照實際需求調整參數，例如只輸出特定鏡頭、變更時間格式或調整字體大小等。建議一開始先挑選一段影片進行測試，確認轉出效果符合預期後再批次處理其他檔案，能節省時間，也能避免重複操作。

範例指令（僅轉出前鏡頭）：

tesla_dashcam \
--no-left --no-right --no-rear \
--monitor_once \
--scale 1 \
--timestamp_format "%Y-%m-%d %H:%M:%S" \
--fontsize 35 \
--output ~/Downloads/output \
~/Downloads/input

各參數說明：

• --no-left --no-right --no-rear：排除左、右、後鏡頭，僅輸出前鏡頭畫面。
• --monitor_once：執行一次後結束，不持續監控資料夾。
• --scale 1：影片輸出比例，1 表示原始大小。
• --timestamp_format：時間顯示格式，可自由調整（例如 %H:%M 顯示時分）。
• --fontsize：時間字體大小，依畫面需求調整。
• --output：輸出資料夾。
• 最後一個參數是輸入資料夾。

如需設定輸出畫面的鏡頭組合與排列方式，可直接參考以下對照表，依需求選擇對應參數。在執行指令時，只需將表中所列參數加入轉檔指令中，例如若僅需保留前鏡頭畫面，可加入 –no-left –no-right –no-rear；若想輸出四分割畫面，則加上 –layout WIDESCREEN。

不必每次都搬出完整四鏡頭的影片，只要保留原始檔名（例如 2025-05-30_15-00-28-front.mp4），即使僅處理單一檔案也能正常執行。若缺少其他鏡頭，建議加上 –no-left、–no-right、–no-rear 等參數，以避免顯示錯誤訊息。

工具會根據影片的起始與結束時間，自動命名輸出檔案，例如：輸入 2025-05-30_15-00-28-front.mp4，輸出為 2025-05-30T15-00-28_2025-05-30T15-01-27.mp4。檔案名稱清楚標示實際影片的時間範圍，方便後續整理與檢索使用。

不過，tesla_dashcam 目前尚未支援處理 B 柱鏡頭（left_pillar、right_pillar）的影片，無法將這兩個視角納入最終合成畫面。若有處理六個鏡頭畫面（前、後、左右重複器與左右 B 柱）的需求，可參考近期社群開發的另一套開源工具 Sentry-Six。

延伸閱讀

特斯拉行車記錄器怎麼看？TeslaCam 哨兵模式檢視器免下載就能使用

特斯拉哨兵模式行車記錄器隨身碟、記憶卡推薦

如何用 iPhone 讀取 Tesla 行車記錄器、哨兵影片

Homebrew 是什麼？

Homebrew 是一個在 Mac 上使用的套件管理工具，可以幫助使用者輕鬆安裝、升級和管理各種軟體套件。它的優點是易於安裝和使用，並且可以通過終端機指令進行操作。此外，它也具有高度的可定制性，可以根據使用者的需求自由配置和管理套件庫。

安裝 Homebrew

安裝 Homebrew 非常簡單，只需在 macOS 的終端機（推薦下載 iTerm2）輸入以下指令即可：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

這個指令會下載 Homebrew 的安裝腳本並進行安裝。安裝過程可能需要輸入密碼，請按照終端機提示進行操作。

如果你對終端機及指令列操作已經有一定的知識，使用 Homebrew 將會非常容易上手，輕鬆提高生產力和工作效率。

Homebrew 支援 M1、M2 的 Mac 嗎？

是的，Homebrew 從 3.0.0 版本開始，正式支援 Apple 的 ARM64 架構 M1 晶片，因此你可以在搭載 M1 或 M2 晶片的 Mac 使用 Homebrew。不過，你可能需要注意一些安裝和使用上的細節，例如你可能會遇到一些相容性問題，因為並不是所有的套件都支援 Apple 晶片。

Homebrew 如何使用？

安裝完 Homebrew 後，就可以開始使用它來安裝和管理軟體套件了。以下是一些常用的 Homebrew 操作指令：

• 安裝 Homebrew 套件：brew install [package]，例如：brew install wget
• 更新已安裝的 Homebrew 套件：brew upgrade [package]，例如：brew upgrade wget
• 列出已安裝的 Homebrew 套件：brew list
• 查看 Homebrew 套件的訊息：brew info [package]，例如：brew info wget
• 搜尋可用的 Homebrew 套件：brew search [keyword]，例如：brew search python

Homebrew 套件推薦

Homebrew 可以快速在 macOS 系統上安裝 node、git、wget、yarn、python3、docker 以及 putty 等無數種開發者所需的程式套件。如果你認得這些套件，那麼你應該知道自己需要什麼。以下為一般使用者，推薦一些實用的 CLI 套件：

youtube-dl

youtube-dl 可以從 YouTube 或影音平台下載影片，支援多種格式和畫質選項，且能批次下載播放清單和字幕，功能非常強大，比一般網路上的 YouTube 下載器更加簡單快速。

不過因為 youtube-dl 太受歡迎，YouTube 官方疑似針對 youtube-dl 進行降速，因此也推薦使用 youtube-dl 的 變體 分支 yt-dlp，yt-dlp 比較不會遇到限速問題，且能夠下載一些 youtube-dl 不支援的網站。

opencc

opencc 是知名的繁簡轉換套件，支援中國大陸、台灣和香港之間的字形變體和地區習慣用語，可以直接將 txt 文字檔、srt 字幕檔等文字檔案中的內容直接轉換。

所有 Homebrew 可用的套件可以在 Homebrew Formulae 網頁中找到，你也可以直接在 homebrew 中搜尋，指令如前面提到：brew search [keyword]，例如：brew search python

安裝 Homebrew Cask

Homebrew Cask 是 Homebrew 的一個擴充功能，可以讓使用者管理圖形化的 macOS 應用程式。Homebrew 主要是用來安裝或管理開源的指令列工具，而 Homebrew Cask 則可以讓你用 brew install –cask 這樣簡單的方式來安裝或更新你想要的 GUI 應用程式，例如 Google Chrome 等常見軟體。

值得注意的是，安裝 Homebrew Cask 的指令 brew tap caskroom/cask 在 2019 年 10 月左右改為 brew tap homebrew/cask。這是因為該次改版時，其套件庫 caskroom/cask 被移動到 homebrew/cask-cask 所致，目前網路上許多教學文章仍顯示舊版指令。

安裝 Homebrew-cask 的新版指令

brew tap homebrew/cask

Homebrew Cask 套件推薦

Homebrew Cask 可以快速幫我們安裝常見的應用程式，例如 Visual Studio Code、FireFox 和 Google Chrome 等，因此我們不用上 Google 一個個搜尋、下載安裝檔，只要打開終端機，透過 CLI 指令就能安裝所有必要的軟體。

跟安裝 Homebrew Cask 的指令一樣，在新版的 Homebrew Cask 中，安裝軟體的指令也有一些調整，指令結構邏輯是將 --cask 放在指令後方，以下列舉幾個常見軟體的安裝指令：

brew install --cask google-chrome

brew install --cask notion

brew install --cask spotify

所有可用的套件可以在 Homebrew Cask 的 Homebrew Formulae 網頁中找到，如果不確定特定的軟體是否可以透過 Homebrew Cask 安裝，可以直接在 Homebrew Formulae 網頁中搜尋。

Apple TV 4K 空拍螢幕保護程式－aerial

除了安裝一般軟體之外，Homebrew Cask 還能安裝螢幕保護程式。Aerial 是一個模擬 Apple TV 螢幕保護程式的軟體，它可以讓你在 Mac 上欣賞高畫質的空拍影片，早期 aerial 僅提供 Apple 官方的空拍影片，後期加入了其他第三方的空拍來源。

如何更新 Homebrew 套件？

推薦一個一氣呵成的指令，幫助你更新和維護你透過 Homebrew 安裝的套件：

brew update && brew upgrade && brew cleanup

這個指令的含義如下：

• brew update：這個指令會更新 Homebrew 本身，以及你安裝的所有套件的資訊。
• brew upgrade：這個指令會將你安裝的所有套件更新到最新版本，如果有依賴關係也會一併升級。
• brew cleanup：這個指令會清理掉你不再需要的舊版本套件以及其他暫存檔案並釋放空間。

最後這三個指令透過 && 整合在一起，就可以一次依序執行。

如何移除 Homebrew 套件？

跟安裝的指令很像，只要將 install 替換為 uninstall 即可，例如：

brew uninstall --cask google-chrome

值得注意的是，如果該軟體在透過 Homebrew Cask，有另外下載安裝檔來更新若重裝軟體，Homebrew Cask 指令可能會失效。

為什麼我要使用 Homebrew？

作為 Mac 上最受歡迎的套件管理工具，Homebrew 具有以下優點：

1. 易於安裝和使用：Homebrew 的安裝非常簡單，只需在終端機中輸入一行指令即可。使用 Homebrew 也非常方便，只要透過終端機指令即可完成各種操作。
2. 高度客製化：Homebrew 可以透過修改對應的描述檔（設定檔）來進行自訂。使用者可以自由新增、刪除或修改套件庫中的軟體，並設定對應的環境變數來控制其行為。
3. 支援多種軟體：Homebrew 支援安裝和管理多種不同的軟體，包括指令列工具、開發庫、應用軟體等。使用者可以透過搜尋、安裝和更新指令輕鬆管理各種 Homebrew 套件。
4. 即時更新和維護：Homebrew 的開發者和社群活躍，即時更新和維護套件庫中的軟體，可以在短時間內修復潛在的安全性漏洞。

本站會持續更新 Homebrew 相關應用，若對相關文章有興趣，不妨關注本站的 Homebrew 文章標籤，定期查看最新的教學文章。

套件 youtube-dl 是在 GitHub 上公開的開源軟體，透過終端機 CLI 操作，非常輕量、效率極佳，可以完全依照自己想要的畫質、格式來下載 YouTube 影片。

下載 youtube-dl

請先安裝 Homebrew，安裝方式可以參考最上方的文章連結。若你已經裝好 Homebrew，則可以透過指令來安裝 youtube-dl，打開終端機並輸入：

brew install youtube-dl

youtube-dl 應該就會自動下載並安裝

安裝 ffmpeg

我們下載 YouTube 影片時可能會用到轉檔、嵌入字幕等功能，這些工作必須交由 ffmpeg 套件來處理。

brew install ffmpeg

執行

如上面所說，youtube-dl 沒有 GUI，而是透過終端機 CLI 操作，因此在應用程式資料夾裡是找不到它的，必須使用終端機來操作。

選擇影片下載位址

在 macOS 中，終端機預設目錄是使用者資料夾，路徑是：Macintosh HD > 使用者 > 使用者名稱，這個目錄就如同 Windows 的 C:Users使用者名稱

但我們一般下載影片通常不會存在使用者資料夾，因此我們可以先指定下載目錄，例如：下載項目。我們可以在終端機輸入 cd Dow 並按下 tab 鍵，自動帶出完整個目錄名稱 cd Download 再按下 Enter 前往。

下載影片

選擇好下載資料夾後，在終端機輸入  youtube-dl <影片網址> 並按 Enter 鍵，預設會選擇影片的最佳畫質和聲音，以 YouTube 第一支影片 Me at the zoo 為例，下載指令如下：

youtube-dl https://www.youtube.com/watch?v=jNQXAC9IVRw

按下 Enter 之後 youtube-dl 便開始下載，在沒有設定任何下載選項的狀況下，可以看到這支影片以預設的 WebM 格式下載到下載項目資料夾中。在 YouTube 下載影片，來源的影片檔案可能是各種格式、分段或是影音分開，因此會再自動交由 ffmpeg 將其轉換為單一的影片檔案。

下載播放清單

輸入 youtube-dl <播放清單網址> 並按 Enter 鍵，可以下載整個播放清單中所有影片。

下載音樂

輸入 youtube-dl -x –audio-format mp3 <影片網址> 並按 Enter 鍵，可以下載影片的音訊部分，並轉檔成 mp3 格式。

影片轉檔

剛剛下載的影片是 WebM 格式儲存（有時可能是 mp4 或 mkv 等等）不過其實 WebM 通常用於網頁播放，我們一般在電腦、手機播放或剪輯，其實還是以 mp4 最通用。因此，我們可以在 youtube-dl 下載影片時，在指令後方加入 -f mp4 即可指定下載成 mp4 檔案格式：

youtube-dl https://www.youtube.com/watch?v=jNQXAC9IVRw -f mp4

所以 -f 後面的檔案格式也可以換成 3gp、aac、flv、m4a、mp3、mp4、ogg、wav、webm 等。如果想知道影片有什麼格式（跟畫質選項）可以選擇，只要輸入 youtube-dl -F <影片網址> 並按 Enter 鍵，就會顯示影片的所有可用格式和代碼。

下載完成的檔案，以 YouTube 來說，下載的檔案名稱就是 影片名稱-影片網址的編號.檔案格式。

嵌入字幕

有時 YouTube 影片會有不同語言的 CC 字幕可選擇，我們可以透過 youtube-dl 將字幕嵌入到影片中。

首先我們先列出可以下載的字幕，以一日幕僚影片為例，在 youtube-dl 下載指令後方加入 --list-subs

youtube-dl https://www.youtube.com/watch?v=Qkf4farak1k --list-subs

youtube-dl 分析 YouTube 網頁後，在最下方 Available subtitles 列出可用的字幕包含：

• zh-CN
• en
• zh
• zh-TW

也就是簡體中文、英文、中文、中文(台灣)這幾種選擇

有關嵌入字幕的 youtube-dl 指令：

• --write-sub下載字幕
• --embed-sub嵌入字幕
• —-sub-lang zh-TW指定語言（以中文(台灣)為例）
• --all-subs下載所有字幕（如果要將所有可用的字幕嵌入）

因此如果我們要下載嵌入中文(台灣)字幕的 mp4 影片，指令為：

youtube-dl https://www.youtube.com/watch?v=Qkf4farak1k --write-sub --embed-sub --sub-lang zh-TW -f mp4

支援嵌入字幕的影片格式包含：mp4、mkv 以及 webm；與格式工廠、HandBreak 那種將字幕直接寫入（燒錄？）在影片畫面上的方式不同，使用 youtube-dl 嵌入的字幕是可以選擇開啟或關閉，以及選擇不同語言的。此外，語系的代號大小寫有別，必須一模一樣，例如中文(台灣) zh-TW 的 TW 一定要是大寫，非常重要！

下載完成後，以 QuickTime Player 打開，可以看到出現中文字幕的選項；若是以其他播放軟體如 MPlayerX 開啟，應該也是可以選擇字幕的，不過每個軟體顯示情況可能有所不同，例如 MPlayerX 顯示的字幕名稱為 noname [zho]，我們測試時剛好只嵌入一種字幕，所以我們知道是繁體中文；若是嵌入多個字幕語言，可能就會比較難以分辨了。

設定下載位置

使用終端機，預設的目錄應該是「使用者資料夾」，因此若單純使用 youtube-dl 加影片網址的指令下載，應該會直接儲存到使用者資料夾中，這邊我們可以建立一個 youtube-dl 的設定檔，來設定預設的下載位置。一樣使用終端機，輸入：

mkdir -p ~/.config/youtube-dl

touch ~/.config/youtube-dl/config

vi ~/.config/youtube-dl.conf

接著按鍵盤 i 進入編輯模式，並貼上：

--output "/Users/使用者名稱/Downloads/%(title)s.%(ext)s"

請記得將使用者名稱替換成 macOS 使用者的目錄名稱。小撇步：可以先輸入 --output " 接著將「下載項目」或你想要的資料夾，拖曳到終端機中，帶入目錄路徑，再貼上 /%(title)s.%(ext)s" 結尾，就可以快速得到正確的路徑了。

接著按鍵盤 ESC 退出編輯模式，輸入 :x 再按 ENTER 儲存。

以上這段如果不太理解，可以先 Google 一下「vi 指令」學習一下這個編輯器怎麼使用。

替代方案

筆者在使用 youtube-dl 之餘，偶爾也會使用 Downie 這套付費軟體（包含在 Setapp 的方案中）這套軟體功能也非常強大，支援下載 YouTube 影片以及其他各式各樣的影音網站，包含 Facebook Watch、Instagram Reels、TikTok 跟抖音等等。若對於終端機指令不熟悉或覺得麻煩的朋友，可以試試透過 Downie 來下載。