OpenClaw 在按天租 Mac 上部署的 5 個關鍵注意點：
臨時環境避坑指南

導語摘要：許多開發者想先按天租 Mac 試用 OpenClaw，再決定是否長期自建。本文針對此情境，說明臨時租用環境與自建 Mac 的差異、網關令牌與 LaunchAgent 正確配置避免 Token Missing、Skills 安裝路徑選擇、租期結束時的備份與恢復流程，以及埠佔用、Node 版本、權限等常見錯誤速查。文末附對比表與 5 步落地流程，可引用數據含 Gateway 預設埠 18789、OpenClaw 推薦 Node 22+、Skills 目錄結構等。

目錄

• ① 按天租 Mac 環境的特點：和自建 Mac 的差異
• ② 網關令牌與 LaunchAgent：正確配置避免「Token Missing」
• ③ Skills 安裝與路徑：臨時環境下如何選目錄
• ④ 租期結束／續租：如何備份配置、快速恢復
• ⑤ 常見錯誤速查：埠佔用、Node 版本、權限問題

① 按天租 Mac 環境的特點：和自建 Mac 的差異

按天租 Mac 與自建 Mac 的最大差異在於：環境是暫時的。租期結束後，您可能無法保留同一台機器，配置與資料需在到期前備份或遷移。此外，租用 Mac 通常為預設映像檔，可能未預裝 OpenClaw，您需自行執行安裝與設定。若選用 MacDate 的預裝映像檔，則可跳過大部分部署步驟；但若需自建，以下差異務必掌握。

典型痛點包括：

• 限制一： 環境不可持續——租期結束即釋放，若未備份配置，下次開新機需重新來過。
• 限制二： 隱性成本——自建 Mac 可長期累積 Skills、自訂設定；按天租用則需在短時間內完成「安裝→配置→使用→備份」的完整流程。
• 限制三： 權限與審計——租用 Mac 可能由多人輪用或映像檔重置，個人設定需放在非系統目錄，且需注意 API 金鑰等敏感資料不外洩。

因此，在按天租 Mac 上部署 OpenClaw 時，應優先考慮：① 將配置與 Skills 放在可備份、可遷移的目錄；② 正確配置 LaunchAgent 讓 Gateway 開機自啟；③ 租期結束前完成備份清單。

② 網關令牌與 LaunchAgent：正確配置避免「Token Missing」

OpenClaw Gateway 需透過 OPENCLAW_GATEWAY_TOKEN 驗證連線。若 LaunchAgent 啟動時未載入該變數，會出現 「Token Missing」 錯誤，導致擴展、Skills 無法連上 Gateway。許多開發者首次部署時會忽略此點，直接執行 launchctl load，結果 Gateway 雖啟動但拒絕連線，除錯時常耗費大量時間。

在按天租 Mac 上，常見問題是 LaunchAgent 的 plist 使用 ~ 路徑，而 launchd 在不同使用者環境下可能解析錯誤；或環境變數未正確注入 plist。此外，若您透過 VNC 遠端操作，登入 session 與 launchd 的 session 可能不同步，導致 plist 載入後仍讀不到 Token。

正確做法：在 plist 中明確設定環境變數

於 ~/Library/LaunchAgents/com.openclaw.gateway.plist 中，加入 EnvironmentVariables 區塊：

# 編輯 LaunchAgent plist
<key>EnvironmentVariables</key>
<dict>
  <key>OPENCLAW_GATEWAY_TOKEN</key>
  <string>您的實際 Token</string>
</dict>

若不想把 Token 寫進 plist（安全性考量），可改用 LimitLoadToSessionType 搭配登入時執行的 shell 腳本，在腳本中 export OPENCLAW_GATEWAY_TOKEN=... 後再 launchctl load 該 plist。但對短期試用而言，plist 內寫入 Token 較簡單，只要確保 plist 權限為 600 即可。載入後可執行 launchctl list | grep openclaw 確認進程是否正常運行。

③ Skills 安裝與路徑：臨時環境下如何選目錄

OpenClaw Skills 預設可能安裝於 ~/.openclaw/skills 或專案內目錄。在按天租 Mac 上，建議建立獨立沙盒目錄，方便備份與遷移：

• 推薦路徑： ~/openclaw-sandbox/skills —— 與系統預設目錄分離，租期結束時直接打包整個 openclaw-sandbox 即可。
• 避免： 將 Skills 放在 /tmp 或系統會定期清理的目錄。
• 環境變數： 若 OpenClaw 支援自訂 Skills 路徑（如 OPENCLAW_SKILLS_PATH），在啟動前設定為 ~/openclaw-sandbox/skills。

# 建立並使用自訂 Skills 目錄
mkdir -p ~/openclaw-sandbox/skills
export OPENCLAW_SKILLS_PATH=~/openclaw-sandbox/skills
openclaw skill install 某個 skill 名稱

ClawHub 上有數千個社群 Skills，建議先安裝少量核心 Skills 驗證流程，避免在租期結束前因安裝過多依賴而難以備份。每個 Skill 通常包含 skill.json 與相關程式碼，打包整個 openclaw-sandbox 即可完整遷移。

④ 租期結束／續租：如何備份配置、快速恢復

租期結束前，務必完成以下備份清單，以便續租或遷移至新機時快速恢復：

步驟一：備份 Skills 目錄

將 ~/openclaw-sandbox/skills（或您自訂的 Skills 路徑）打包為 openclaw-skills-backup.tar.gz，下載至本地或上傳至雲端。

步驟二：備份 OpenClaw 配置檔

備份 ~/.openclaw 目錄下的配置檔（如 config.json、.env 等），注意勿備份 API 金鑰等敏感資訊至公共儲存。

步驟三：記錄 LaunchAgent plist 內容

將 ~/Library/LaunchAgents/com.openclaw.gateway.plist 的內容複製保存，新機上可直接貼回並修改路徑後載入。

步驟四：記錄 Node 版本與依賴

執行 node -v 與 openclaw --version，記錄版本號，新環境需安裝相同或相容版本。

步驟五：恢復流程

新機上：安裝 Node 22+ → 安裝 OpenClaw → 還原配置與 Skills → 載入 LaunchAgent → 驗證 Gateway 與擴展連線。若使用 MacDate 續租或新開機，可選擇同一節點以降低網路延遲；若遷移至自建 Mac，確保 Node 與 OpenClaw 版本相容即可。

⑤ 常見錯誤速查：埠佔用、Node 版本、權限問題

按天租 Mac 上部署 OpenClaw 時，以下錯誤最常見：

• 埠佔用： Gateway 預設埠為 18789，若被其他程式佔用，會啟動失敗。執行 lsof -i :18789 檢查，必要時修改 OpenClaw 配置改用其他埠。
• Node 版本不符： OpenClaw 要求 Node.js 22+。執行 node -v，若版本過舊，使用 nvm 或 fnm 安裝 Node 22。
• 權限問題： LaunchAgent 以目前使用者身份運行，若 plist 權限過於開放（如 777），launchd 可能拒絕載入。建議 plist 為 644，含 Token 的敏感檔為 600。
• 「Token Missing」： 確認 plist 內 EnvironmentVariables 已正確設定，或啟動前在 shell 中 export OPENCLAW_GATEWAY_TOKEN。

可引用資訊：

• OpenClaw Gateway 預設埠：18789；擴展 Relay 預設埠：18792
• OpenClaw 推薦 Node.js 版本：22+
• Skills 目錄結構：~/.openclaw/skills 或自訂 OPENCLAW_SKILLS_PATH

總結：在按天租 Mac 上部署 OpenClaw 時，需特別留意臨時環境的差異——網關令牌正確注入 LaunchAgent、Skills 放在可備份目錄、租期結束前完成備份、掌握埠佔用與 Node 版本等常見錯誤。若您希望跳過部署步驟、開箱即用，可選擇 MacDate 提供的 OpenClaw 按天嘗鮮套餐，預裝零配置環境，直接開始體驗。