集群環境與節點準備
部署前請確認以下條件，以便後續步驟可一致複現：
- 節點數量與規格：至少兩台可透過 SSH 連線的 Mac（建議 M4、16GB+ 記憶體），用於構成 MeshMac 集群。
- 網路：多節點處於同一內網，或透過 VPN／Tailscale 互通，確保可互相解析主機名或 IP，且延遲穩定。
- SSH：各節點已啟用 SSH、建議使用金鑰登入，避免密碼暴露與自動化腳本依賴。
- 可選：NFS 或內網共享卷，用於共用構建產物或配置檔，減少各節點重複下載。
建議先以兩台節點完成整篇教程驗證，再擴展到更多節點，可降低排查難度。
各節點安裝與統一配置
為確保集群行為一致，各節點應使用同一版本的 OpenClaw Runtime 與設定檔。可依下列步驟複現：
- 基準節點：在任選的一台 Mac 上安裝 OpenClaw Runtime 與所需依賴，完成 YAML 設定，並確認單機可正常執行一個簡單任務。
- 分發：使用 SCP、rsync 或 Git 將同一版本二進位與設定檔分發至其餘節點，確保路徑與權限一致（例如
~/openclaw/）。 - 唯一識別：為每台節點設定唯一 node_id 或 hostname，避免任務佇列與日誌中節點識別衝突。
- 共用後端：在設定檔中指定同一任務佇列與狀態後端位址（如 Redis URL 與 namespace），確保多節點共用同一真實來源。
- 啟動順序：先啟動佇列／狀態服務（如 Redis），再依序或並行啟動各節點 OpenClaw；以一個簡單任務驗證多節點可領取任務並回寫狀態。
若使用 Meshmac 租用的多台 Mac，每台已具備獨立 IP 與 SSH，可直接從步驟 1 開始在首台完成安裝後再分發。
多用戶權限隔離
多台遠端 Mac 協作時，常有多位成員共用同一節點或同一集群，權限隔離可避免互相覆蓋設定、誤刪產物或安全風險。建議做法：
- 系統帳號：為每位成員建立獨立 macOS 使用者帳號（或每專案一帳號），避免多人共用同一登入帳號。
- SSH 金鑰：每位成員使用專屬 SSH 公鑰，並僅寫入對應帳號的
~/.ssh/authorized_keys，便於審計與撤銷。 - 目錄權限：專案或構建目錄使用適當 umask 與群組（如
staff或自建群組），必要時以 ACL 細化讀寫執行權限。 - 任務隔離：若 OpenClaw 支援 namespace 或 project key，可依團隊／專案劃分，避免任務與狀態互相干擾。
更細的 SSH／VNC 選型與權限實戰可參考站內遠端 Mac SSH 與 VNC 選型指南、共享構建機權限管理。
故障轉移與高可用配置
集群要具備故障轉移與基本高可用，需保證：任務佇列與狀態不因單點故障丟失、節點或後端掛掉時可自動或手動切換。可複現要點如下：
- 單一後端：任務佇列與狀態使用 Redis（或分散式 KV）作為單一真實來源；若需高可用，可配置 Redis 主從或叢集，並在客戶端設定重試與逾時。
- 健康檢查：各節點 OpenClaw 或外層編排腳本可定期檢查佇列與狀態服務連線，失敗時記錄日誌並可觸發告警或重試。
- 啟動順序：先啟動 Redis／狀態服務，再啟動各節點 OpenClaw，避免節點啟動時連不到後端導致任務遺失。
- 可選：若有多個 Redis 實例或負載均衡（如 VIP），在設定檔中填寫對應位址；單節點故障時，任務可由其他節點從佇列領取繼續執行。
小團隊可先採用單一 Redis + 多節點 Worker 的架構，即可達成「單機掛掉、任務不丟、由其他節點接手」的基礎故障轉移。
常見報錯與排查
依下列情境對照排查，多數問題可快速定位：
- Redis／KV 連線失敗：檢查防火牆是否放行對應埠（如 6379）、Redis 是否只監聽 127.0.0.1（跨機需改為 0.0.0.0 或綁定內網 IP）、網路是否互通（ping／telnet）。
- 節點無法領取任務：確認各節點 node_id 唯一、佇列 URL 與權限正確、後端服務已啟動；查看 OpenClaw 日誌是否有連線或認證錯誤。
- 狀態不同步或遭覆蓋：確認所有節點使用同一 namespace、寫入邏輯帶版本或時間戳；檢查日誌是否有權限錯誤或連線中斷。
- SSH 或權限問題：依站內小團隊遠端 Mac FAQ（SSH／VNC／權限隔離）檢查金鑰、帳號與目錄權限。
若問題仍無法排除，可至 Meshmac 幫助中心查閱集群與 OpenClaw 相關說明，或聯繫支援。