OpenClaw 安裝指南：macOS、Linux 與 Windows

OpenClaw 是一款本機工具，可讓你的 AI agent 連接 Telegram 或 WhatsApp 等應用程式並執行動作，例如傳送訊息或處理任務。只要理解流程，設定起來並不複雜。本指南涵蓋 macOS、Linux 與 Windows 的安裝方式。

OpenClaw 設定選項快速總覽

請選擇符合需求的設定方式。在本機執行 OpenClaw 可讓一切保留在自己的電腦上，但需要安裝 npm 等相依套件，或使用自動化腳本。若想省去設定，Kimi Claw 這類全託管平台會替你處理執行環境，讓你直接開始使用。

如何在 macOS 與 Linux 安裝 OpenClaw

macOS 與 Linux 使用相同的安裝程式與指令。除非另有說明，以下步驟皆適用於兩個系統。

以下是快速設定指南。若需要含螢幕截圖的完整逐步教學，請參閱如何在 macOS 安裝 OpenClaw。

方法一：使用單行安裝腳本

步驟 1：在 Terminal 執行安裝腳本

執行官方安裝腳本來設定 OpenClaw。腳本會檢查是否已安裝 Node.js 22 或更新版本；若缺少或版本過舊，會自動安裝 Node.js 24。接著會安裝 OpenClaw CLI，並啟動新手引導精靈。

步驟 2：完成新手引導精靈

依照新手引導精靈設定你的 agent 環境，包括選擇模型供應商（例如 Kimi API）、輸入 API key、選擇通道，以及完成基本設定。

步驟 3：檢查安裝結果

執行以下指令，確認你的 OpenClaw 版本。

步驟 4：驗證 gateway 並完成設定

執行以下指令，確認 OpenClaw gateway 已啟用。

安裝程式也會在 macOS 註冊 LaunchAgent，或在 Linux 註冊 systemd 服務，讓 OpenClaw 持續在背景執行。全部設定完成後，你的 agent 就可以開始使用。你可以開始對話、連接工具，或依需求設定工作流程。

方法二：使用 Homebrew 安裝

步驟 1：安裝或升級 Node.js

在 Terminal 執行以下指令，使用 Homebrew 安裝 Node.js。若已安裝 Node.js，請改執行升級指令，確保使用最新版本。

步驟 2：安裝 OpenClaw CLI

執行以下指令，全域安裝 OpenClaw CLI。

步驟 3：執行新手引導並設定 daemon

執行以下指令，啟動新手引導精靈並註冊背景 daemon。依照精靈設定你的 agent 環境，包括選擇模型供應商（例如 Kimi API）、輸入 API key，以及連接訊息通道。設定完成後，你的 agent 就可以開始使用。你可以開始對話、連接工具，或依需求設定工作流程。

方法三：使用 npm 安裝

步驟 1：確認執行環境版本

執行以下指令，確認系統已安裝 Node.js 22.14 或更新版本。若版本符合要求，即可繼續安裝。

步驟 2：安裝 OpenClaw CLI

執行以下指令，全域安裝 OpenClaw CLI。

步驟 3：執行新手引導並啟用持續執行

執行以下指令，啟動新手引導精靈並註冊背景 daemon。依照精靈設定你的 agent 環境，包括選擇模型供應商（例如 Kimi API）、輸入 API key，以及選擇訊息通道。設定完成後，你的 agent 就準備好了。你可以開始與它互動、連接工具，或依需求建立工作流程。

平台注意事項： OpenClaw 支援 Intel 與 Apple Silicon Mac。若安裝遭 Gatekeeper 阻擋，可在「系統設定」的「隱私權與安全性」中允許。

如何在 Windows 安裝 OpenClaw

在 Windows 上安裝 OpenClaw 主要有三種方式：使用 PowerShell 安裝程式快速完成原生設定、透過 WSL2 建立完整 Linux 環境，或使用 npm 手動安裝。

以下是快速設定指南。若需要含螢幕截圖的完整逐步教學，請參閱如何在 Windows 安裝 OpenClaw。

方法一：使用 PowerShell 安裝程式（原生 Windows）

步驟 1：在 PowerShell 執行安裝腳本

以系統管理員身分開啟 PowerShell，執行官方單行腳本來安裝 OpenClaw。

步驟 2：完成新手引導精靈

依照新手引導步驟設定你的 agent 環境，包括選擇模型供應商（例如 Kimi API）、輸入 API key，以及選擇訊息通道。

步驟 3：驗證安裝

執行以下指令，確認 OpenClaw 已正確安裝且 gateway 已啟用。

步驟 4：開始使用你的 agent

設定完成後，你的 agent 就準備好了。你可以開始與它互動、連接工具，或依需求設定工作流程。

方法二：使用 WSL2 安裝

步驟 1：設定 Linux 環境

以系統管理員身分開啟 PowerShell，執行以下指令以啟用並初始化 WSL2。

步驟 2：在 Linux 中執行安裝程式

開啟你的 Linux 終端機，執行標準安裝腳本來安裝 OpenClaw。

步驟 3：完成新手引導精靈

依照新手引導步驟設定你的 agent 環境，包括選擇模型供應商（例如 Kimi API）、輸入 API key，以及選擇訊息通道。

設定完成後，你的 agent 就準備好了。你可以開始與它互動、連接工具，或依需求設定工作流程。

方法三：在 Windows 使用 npm 安裝

步驟 1：檢查 Node.js 版本

執行以下指令，確認 Node.js 已安裝且為最新版本。

步驟 2：安裝 OpenClaw CLI

執行以下指令，全域安裝 OpenClaw CLI。

步驟 3：執行新手引導並啟用持續執行

執行以下指令，啟動新手引導精靈並註冊背景 daemon。

依照新手引導步驟設定你的 agent 環境，包括選擇模型供應商（例如 Kimi API）、輸入 API key，以及選擇訊息通道。

設定完成後，你的 agent 就準備好了。你可以開始與它互動、連接工具，或依需求設定工作流程。

如何使用 Kimi Claw 線上執行 OpenClaw

上述方法都需要終端機、受支援的 Node.js 版本，以及一台持續開機的電腦。Kimi Claw 提供完整託管選項，讓你無需安裝或維護本機環境，也能執行 OpenClaw。

步驟 1：開啟 Kimi Claw 並建立執行個體

前往 Kimi Claw 頁面，點選 Create 開始。

步驟 2：確認部署

在彈出視窗中確認部署。Kimi Claw 會自動設定你的 OpenClaw 環境，包括 gateway 與 workspace，無需任何本機設定。

步驟 3：開始使用你的 workspace

部署完成後，workspace 會在儀表板中開啟。你可以直接在瀏覽器中開始與 agent 互動、設定技能、配置排程任務並管理檔案。

Kimi Claw 主要功能

• 雲端託管： Kimi Claw 會在雲端執行你的 gateway，因此即使本機電腦離線，你的 agent 仍可使用。

• 自動維護： 更新與修補會在背景處理，無需手動設定或重新啟動。

• 內建能力： 包含任務排程、持久儲存，以及依據你的提示詞動態載入技能，並可跨裝置無縫使用。

OpenClaw 常見安裝錯誤疑難排解

OpenClaw 的安裝問題多半屬於幾種常見類型，例如 PATH 設定、缺少相依套件或連接埠衝突。以下章節可協助你快速找出並修復 macOS、Windows 與 Linux 上最常見的問題。

安裝後出現「openclaw: command not found」

OpenClaw 不在你的系統 PATH 中。

• 修復方式： 將 npm 全域 bin 目錄加入 PATH。

接著重新載入 shell（例如 source ~/.zshrc），或重新啟動終端機。在 Windows 上，請將路徑加入環境變數，然後重新啟動 PowerShell。

macOS 上的 Sharp 建置錯誤

這通常是因為全域安裝的 libvips 與 Sharp 函式庫發生衝突。

• 修復方式： 使用此環境變數執行安裝指令。

若看到 node-gyp 錯誤，請安裝 Xcode Command Line Tools：

重新開機後 OpenClaw 未啟動

新手引導期間未安裝背景 daemon。

• 修復方式： 使用 daemon 旗標重新執行新手引導。

接著驗證服務：

Gateway 沒有回應，或顯示「0 tokens used」

gateway 程序可能已停止，或 API 驗證可能失敗。

• 修復方式： 重新啟動 gateway。

執行健康檢查：

查看除錯日誌：

此外，請確認你的 API key 有效。

連接埠 18789 已被使用

另一個程序正在使用 OpenClaw gateway 連接埠。

• 修復方式： 找出並停止衝突的程序

接著重新啟動 gateway：

EACCES 權限錯誤

這通常表示 npm 全域目錄沒有正確的權限。

• 修復方式： 更新目錄擁有權。

在 Windows 上，請以系統管理員身分執行 PowerShell，或設定自訂 npm prefix：

若使用 Docker 設定，請修正 volume 權限：

「spawn git ENOENT」錯誤

Git 未安裝，或無法在 PATH 中使用。

• 修復方式： 從 git-scm.com 安裝 Git，重新啟動終端機，然後再次嘗試安裝。

WSL2 systemd 無法運作

你的 WSL 設定中尚未啟用 systemd。

• 修復方式： 編輯 /etc/wsl.conf 並加入內容。

接著重新啟動 WSL：

重新開啟 Linux 終端機並驗證：

在 VPS 上執行 npm install 時記憶體不足

記憶體較低的 VPS 執行個體可能會在套件安裝期間失敗。

• 修復方式： 建立 swap 檔案。

接著重新執行安裝。

連接訊息平台時出現「Access not configured」

你的帳號尚未獲得 OpenClaw 授權。

• 修復方式： 使用配對碼核准你的帳號。

此外，請確認你的 bot 憑證（token、webhook、權限）已正確設定。

結語

在 macOS、Linux 與 Windows 上安裝 OpenClaw 都很直觀。你可以依據自己的環境，選擇單行腳本、PowerShell、WSL2 或 npm。新手引導精靈會帶你完成模型選擇、API 設定與訊息通道配置。若你不想管理本機環境，Kimi Claw 提供完整託管選項，讓你直接在雲端執行 OpenClaw。