遠端 OpenClaw 設定指南 (macOS ⇄ 遠端主機)

如果你習慣在遠端伺服器跑服務，一定遇過這種狀況：想改個設定或看個狀態，得先開終端機、連 SSH、再找指令。這種操作上的斷層感很消磨開發熱情，要是能直接在 Mac App 介面操作遠端的 Gateway，工作起來會順手很多。

這份教學會帶你設定 OpenClaw 的 Remote over SSH 功能。設定好後，無論是健康檢查、Voice Wake 轉發還是 Web Chat，都能直接在你的 Mac 上搞定。

需要準備的東西

在開始之前，請確保你的遠端主機已經準備好：

• 安裝 Node.js 與 pnpm
• 已安裝並編譯 OpenClaw CLI (pnpm install && pnpm build && pnpm link --global)
• openclaw 指令已加入 PATH（非互動式 Shell 也要能讀到，建議 symlink 到 /usr/local/bin）
• 開啟 SSH 並設定好金鑰登入（推薦使用 Tailscale IP 確保連線穩定）

快速開始

只要 5 分鐘，就能把你的 macOS App 變成遠端控制台。

1. 開啟設定：打開 App 的 Settings → General。
2. 切換模式：在 OpenClaw runs 選項中，選擇 Remote over SSH。
3. 配置連線：
   • Transport：選擇 SSH tunnel (預設) 或 Direct (ws/wss)。
   • SSH target：輸入 user@host（如有需要可加 :port）。如果主機在同個區域網路且有 Bonjour 廣播，可以直接從列表選取。
   • Gateway URL（僅限 Direct 模式）：輸入 wss://gateway.example.ts.net。
4. 測試連線：點擊 Test remote。如果看到成功訊息，代表 openclaw status --json 運作正常。

設定完成後，Web Chat 和健康檢查就會自動透過 SSH 隧道開始運作。

遠端 WhatsApp 登入

如果你需要使用 WhatsApp 頻道，登入流程需要在遠端主機上執行：

1. 在遠端主機執行：openclaw channels login --verbose。
2. 用手機 WhatsApp 掃描螢幕上的 QR Code。
3. 如果連線失效，回主機重新執行此指令即可。

通知聲音設定

現在你可以針對不同的通知自訂聲音，透過 openclaw 指令調用：

openclaw nodes notify --node <id> --title "Ping" --body "Remote gateway ready" --sound Glass

App 內不再提供全域的「預設聲音」開關，你可以根據每個請求的需求來決定要用哪種聲音。

疑難排解

• exit 127 / not found：這代表遠端主機的非登入 Shell 找不到 openclaw 指令。請把它加到 /etc/paths 或 symlink 到 /usr/local/bin。
• Health probe failed：檢查 SSH 是否斷線、PATH 設定是否正確，以及 WhatsApp (Baileys) 是否還在登入狀態。
• Web Chat 卡住：確認 Gateway 有在遠端執行，且轉發的 Port 與 Gateway 的 WS Port 一致。
• Node IP 顯示 127.0.0.1：這是使用 SSH tunnel 的正常現象。如果你需要 Gateway 看到真實用戶 IP，請將 Transport 改為 Direct (ws/wss)。

---

還有設定上的疑問嗎？試試我們的 AI Setup Assistant 獲取即時幫助。

下一步

• 安全性設定
• 搭配 Tailscale 使用