這是一份關於將 HomeLab 服務從傳統 Docker Compose 遷移至 Kubernetes (OrbStack) 的完整技術紀錄。特別針對 8GB RAM 的 Mac 進行了極致的資源最佳化。 1. 核心架構 (Infrastructure) 本次遷移的核心目標是在有限的資源下，建立一個現代化、易於管理的微型資料中心。 基礎設施 我們捨棄了耗費資源的 Docker Desk...

Mac、Oracle VPS 與 GitHub 協作流程 背景 本文件的目的是記錄一種在多種環境下協作管理專案資料的工作流程，適用於以下情境： 在本機 Mac 編寫設定檔（使用 Claude Code AI 輔助） 在 Oracle VPS（1GB RAM）上實際操作 Kubernetes（k0s + k9s） 將專案備份到 GitHub 個人倉庫 未來轉移到新主機時...

背景 在 Zeabur 上部署 Hermes Agent 的過程中，發現語音轉文字功能（faster-whisper）無法正常載入。調查後發現原因是：faster-whisper 並非在 Docker image 建置時安裝，而是透過 lazy_deps 機制在第一次使用時動態安裝，但安裝路徑與 Hermes Agent 的 Python 環境不同。 問題分析 Hermes Agent...

這次升級的目標 從 v2026.5.12 升級到 v2026.5.19。這次升級的重點是： 對齊官方最新版本 修復 arm64 build 失敗問題 使用統一的 tag 策略 arm64 Build 失敗問題 問題描述 在 Docker image 建置過程中，arm64 版本（build-arm64 job）持續失敗，錯誤訊息： [ERR_PNPM_NO_O...

這次升級的背景 從 v2026.5.7 升級到 v2026.5.12，這次不只是版本對齊，更重要的是全面清理不必要的 workflows。 官方維護了大量的 CI/CD 流程，這些流程在我們的 fork 上沒有實際用途，卻消耗 GitHub Actions minutes。 執行的步驟 1. 從官方 v2026.5.12 創建分支 git fetch upstream --ta...

升級流程 Fetch upstream tags，確認新版本 v2026.5.16 建立備份 branch backup-my-config-v2026.4.30 checkout 到 my-config-v2026.5.16 基於上官 v2026.5.16 tag 套用 SSH 自定義修改 觸發 GitHub Actions build → 打 tag v2026....

這次升級的重點 v2026.5.6 → v2026.5.7 的升級過程中，遇到了 commit 數量與歷史取捨的問題。 官方這次有 76 個 commit，但我們選擇只 cherry-pick 必要的自定義修改，而非完整對齊。 為什麼跳過 76 個官方 commit？ 當使用 cherry-pick 策略時，我們的目標是： 站在官方的穩定版本上 套用自己的自定義修改 ...

為什麼要整理 Workflow？ 每次升級 OpenClaw 版本時，官方 repository 會攜帶大量的 GitHub Actions Workflows。這些 workflows 在 fork 的版本上執行時往往沒有實際用途，卻持續消耗 GitHub Actions 的 minutes quota。 這次升級的重點不在於新功能，而是清理與最佳化。 這次做了什麼 1. 建立...

背景 這不只是一次版本號的跳躍，而是一場關於「尊重官方架構」與「解決同步阻塞」的技術修煉。 最終結論：站在巨人的肩膀上 升級過程中我們明白，官方 v2026.4.30+ 已經從內部解決了同步 Staging 導致的 Event Loop 阻塞。 最優雅的解法不是改造環境，而是在官方認證的環境內進行原位預熱，確保 Symlinks 與網路棧的絕對完整。 啟動時間從 51 秒降至 ...

目標 把 OpenSSH server 包進 Docker image，讓 SSH 可以直接進 container，繞過 Docker exec 的 PTY 修飾鍵問題（Shift+Enter 被 normalize 成普通 Enter）。 遇到的問題 問題 1：SSH 進來沒有環境變數 症狀：hermes --tui 報 “no API key found”，但 Telegra...