檔案是存在的。只是放在一個沒用的地方。

做好的 MP4 放在 /data/pi-agent/底下，在一個你手機打不開的容器裡。沒有上傳這一步的話：影片做完 → 打開電腦 → SSH 連進去 → 找到輸出路徑 → 用 scp拉出來 → 再傳出去。有 rclone 的話：影片做完 → 手機收到 Drive 通知 → 分享出去。

rclone 是一個檔案同步工具，就像命令列版的 Drive App，而且已經在容器裡了：不用 apt install rclone，不用另外管理版本。每個指令都長同一個樣子：

這件工作找它做，有三個理由，這篇只講最單純的方向——本地檔案傳到 Google Drive：

• 成熟穩定。 超過十年的開發歷史；token 續期、斷線重試、大檔分片上傳這些細節都處理好了。
• 不綁死 Google。 支援超過 40 種服務：OneDrive、Dropbox、Box、iCloud Drive、Amazon S3、阿里雲 OSS、SFTP、WebDAV。兩端都可以是雲端儲存空間，所以它能把 Drive 的東西複製到 Dropbox，或把 S3 的資料備份到 OneDrive。
• 直接。 檔案是直接從你自己的 Home Assistant 主機傳到你選的供應商；Pi Agent 不會透過任何 WoowTech 雲端服務中轉。

其他任何組合，用的都是同一套「遠端加路徑」的模式。

為什麼 rclone 從來不會要你輸入 Google 密碼

Google 已經不再讓軟體用你的 email 跟密碼直接登入：任何拿到密碼的東西，都能碰到整個帳號——信箱、Drive、你的 YouTube 頻道、付款服務——就算是你信任的軟體，也可能被入侵。這跟一個服務要求讀取你 Google 日曆時用的，是同一套委任存取模型。

flowchart TD
  A["rclone 發起一次授權請求
並印出一個指令
要在有瀏覽器的電腦上執行"] --> B["Google 詢問是否允許 rclone
存取 Drive，範圍是
你選的那個"]
  B --> C["Google 發給 rclone 一張 token
限定在那個範圍內"]
  C --> D["rclone 之後每次傳輸
都出示這張 token"]
  D -.->|"你在
Google Account、Security、
third-party connections 裡撤銷它"| E["儲存的 token
不再能授權 rclone"]

隨時都能到 Google Account → Security → third-party connections撤銷它。只在你確認過網址跟帳號、真正是 Google 的頁面上輸入 Google 密碼；任何其他要求輸入密碼的畫面都直接關掉。

這是唯一一篇要你自己動手打字的章節

這個系列大部分都是靠開口問就能完成。這裡你要自己輸入： rclone config 是互動式的，跑在 Pi Agent 的容器裡。

agent 自己能做到什麼左欄有四個工具；你選的那個，右邊會列出它的說明，一路到參數細節。

• read、bash、edit、write 就是左欄完整的清單。 bash 是 agent 能幫上終端機工作的原因——但下面的授權步驟還是得你自己來。
• read 被選中，右側面板列出它的三個參數： path，必填； offset 跟 limit，選填。它只讀你指定的檔案，不會自己想讀什麼就讀什麼。

1. 步驟 1

   安裝 Advanced SSH & Web Terminal

   前往 Settings → Add-ons → Add-on Store，搜尋 Advanced SSH & Web Terminal，安裝，打開 Web UI。筆電上不需要另外裝任何 SSH 客戶端。

2. 步驟 2

   你還沒進到 Pi Agent 裡

   這個終端機打開的是 SSH add-on 自己的環境：你可能會看到系統路徑，例如 /config/ 跟 /mnt/、 ls /data/pi-agent/ 在這裡可能會顯示「No such file or directory」。這是正確的，不是壞掉——那個路徑是 Pi Agent 的持久化資料。

3. 步驟 3

   找出你自己的容器名稱

   Pi Agent 的容器是 addon_<slug>，透過倉庫安裝的 slug 通常以一段八位字元的倉庫雜湊開頭，例如 b9cf5676_woow_ha_pi_agent。這段雜湊是由倉庫來源算出來的，所以不同的倉庫網址會給出不同的名稱。檢查 Settings → Add-ons → Woow HA Pi Agent → Info 找 Hostname 或 Slug 欄位；如果你的沒顯示，不要用猜的——去查出來：

   docker ps --format '{{.Names}}' | grep pi_agent
4. 步驟 4

   進入你剛剛確認過的容器

   把你自己的 slug 代入 docker exec -it addon_<your-slug> bash ——例如 docker exec -it addon_b9cf5676_woow_ha_pi_agent bash。除非跟你的安裝完全一致，否則不要照抄這個範例。像 root@container-id:/# 這樣的提示符號，代表你已經進去了； ls /data/pi-agent/ 現在應該會列出 sessions、models 跟 rclone。

5. 步驟 5

   接下來都留在這裡

   rclone config， rclone lsd 跟 rclone config reconnect 都需要這個容器：rclone 的執行檔跟持久化設定都放在這裡。如果你看到 rclone: command not found，先停下來檢查提示符號跟容器名稱。

大部分提示都用預設值就好。有兩個例外。

執行 rclone config。不同版本用詞可能不一樣；每個提示都先讀過再按 Enter。

精靈跑完，不代表上傳真的能用

還在容器裡的話，跑 rclone lsd gdrive:。它會印出你「我的雲端硬碟」或共用雲端硬碟根目錄下的目錄：

能列出來就確認了讀取權限。如果根目錄裡沒有任何資料夾，沒有輸出也沒有錯誤也是正常的；建一個資料夾再跑一次，就能得到明確答案。有三種錯誤常常出現：

現在證明你能寫入。如果你的 Drive 根目錄已經有 test.txt，兩行都用一個獨特的名稱，這樣測試才不會覆蓋掉它：

在 Drive App 裡檢查「最近」，讀一下 test.txt 的內容；確認過再從 Drive 裡刪掉它。複製不會動到本地的檔案。

把管線指向一個資料夾

pitch_video 這個 Skill 需要一個目的地，例如 gdrive:PiAgent/Videos/，但這個設定放在哪個欄位因版本而異：讀你安裝那個版本的 SKILL.md、README 跟設定範例，絕對不要假設另一個版本有的欄位這裡也一定有。常見有三種寫法，值都一樣：

一個做完的小型檔案任務一件不同的差事——這裡是 agent 寫了 notes.md——但形狀跟幫你讀一份 SKILL.md 一樣。

• Process details · 2 messages · 2 tool calls 預設是收起來的。想看實際跑了什麼、而不只是摘要的時候，把它打開。
• notes.md 出現了兩次：一次在回覆下面的標籤，一次在 EXPLORER 左側清單裡新增的一項。你不用光憑一句話就相信結果。
• 187 in · 57 out · 1,152 cache R · $0.0032 是這次的花費。讀一份 SKILL.md 大概就是這個等級的工作量。

自己動手建那個 Drive 資料夾，不要讓複製動作順便建出來，這樣你才能先檢查它的位置跟分享權限。保留結尾的 / 在三種寫法裡都一樣；用 rclone copy， gdrive:PiAgent/Videos 的話這也是一個目錄路徑，上傳時要順便改檔名需要用 copyto。

現在跑一次第 11 篇那整條管線。它最後一個階段應該會記錄類似這樣的訊息：

接著到 Drive 裡檢查檔案——名稱、大小、播不播得動。看起來成功的 log 那一行不算驗證。在上傳回報成功、 跟 你自己也看到遠端的檔案之前，不要刪掉本地的輸出。

有一個檔案你該把它當成一把鑰匙

rclone 會把遠端跟它的 token 寫進 /data/pi-agent/rclone/rclone.conf、

refresh_token 會在不用再問你的情況下，換來新的短效存取 token，這也是它能長效運作的原因。任何拿到這個檔案可用副本的人，都能在授權範圍內存取資料，直到你撤銷授權為止。

/data/pi-agent/ 是持久化的 add-on 資料，這帶來兩個後果。升級會替換掉 add-on 打包的檔案系統，但不會動到 /data/ ，所以重啟或升級 Pi Agent 通常不會讓你被打回去重跑一次 OAuth——先看第 15 篇。而 Home Assistant 備份可以在選了 Pi Agent 且備份成功時，把同一個 /data/打包進去，包括 rclone.conf。還原之後，跑 rclone lsd gdrive: ，加上一次無害的上傳測試，不要假設它就一定能用。

Dropbox、OneDrive、S3——或你櫃子裡的 NAS

另一個目的地，就是再跑一次 rclone config、 n 來新增一個遠端，取一個清楚的名字，例如 dropbox， onedrive 或 s3，接著選對應的後端。只有 Storage 步驟之後的問題不一樣：

在真正依賴它之前，先測試那個確切的遠端： rclone lsd dropbox:，再做一次無害的上傳測試，跟 Drive 那次一樣。確認過之後，才把 Skill 的目的地從 gdrive: 改成 dropbox:， onedrive: 或 s3:mybucket/。

你可以同時保留好幾個遠端：一個 Skill 腳本可以跑 rclone copy final.mp4 gdrive:PiAgent/Videos/ 跟 rclone copy final.mp4 dropbox:PiAgent/Videos/。每次傳輸各自消耗自己供應商的額度，也可能各自獨立失敗，所以在宣告成功或刪掉本地來源之前，兩邊的結束狀態跟遠端檔案都要檢查。有兩份副本是備援，不是備份策略——備份策略還需要保留規則跟驗證過的復原流程。

真正會讓人卡住的地方

這時候大家常問的問題

接下來往哪走