操作指南

OpenClaw 深度解析與
本地安裝完整指南

涵蓋 macOS 與 Windows 完整安裝流程、核心配置、常用指令及進階優化建議。

01OpenClaw 是什麼？02macOS 本地安裝教程 03Windows 本地安裝教程 04核心配置與初始化 (Onboarding)05常用操作指令汇總 06進階與優化指令推薦

01OpenClaw 是什麼？

OpenClaw（前身為 Moltbot/Clawdbot）是一個強大的本地化 AI 代理（Agent）系統與網關（Gateway）。其核心優勢在於「本地常駐」與「高度可定製」，能夠將雲端的大語言模型（如 Claude、GPT、Minimax 等）與你的本地環境、文件系統以及第三方通訊軟件（如 Telegram、Discord）無縫連接。

本地 AI 網關

為本地應用提供統一的 API 接口，充當大模型的本地調度中心。

常駐守護進程

開機自啟，7×24 小時在後台默默運行，隨時響應指令。

自動化工作流

允許 AI 直接讀取本地文件、執行腳本或參與自動化任務。

02macOS 本地安裝教程

macOS 的類 Unix 環境非常適合運行 Node.js 應用。我們將使用 Homebrew 來管理底層環境。

第 1 步安裝 Homebrew（包管理器）

打開 macOS 自帶的終端 (Terminal)，複製並運行以下指令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

注：安裝過程中如提示需要輸入密碼，請輸入 Mac 開機密碼，輸入時屏幕不會顯示字符，輸入完按回車即可。

第 2 步安裝 Node.js 環境

OpenClaw 依賴 Node.js 運行（推薦使用 Node 24）：

brew install node@24

第 3 步全局安裝 OpenClaw

使用 Node.js 自帶的 npm 包管理器進行全局安裝：

npm install -g openclaw

03Windows 本地安裝教程

對於不想折騰 WSL（Linux 子系統）的用戶，可以直接在 Windows 原生環境中進行本地安裝。

第 1 步安裝 Node.js 環境

前往 Node.js 官方網站，下載 Node.js 22 LTS 或 Node.js 24 的 Windows 安裝包（.msi 文件），雙擊運行，一路點擊「Next」完成默認安裝（確保勾選了「Add to PATH」選項）。

第 2 步全局安裝 OpenClaw

以管理員身份運行命令提示符。點擊 Windows 開始菜單，搜索 PowerShell，右鍵選擇「以管理員身份運行」，然後輸入以下指令：

npm install -g openclaw

04核心配置與初始化 (Onboarding)

安裝完成後，無論你是 Mac 還是 Windows 用戶，都需要進行首次初始化。在終端中輸入以下指令啟動向導：

openclaw onboard

向導流程指南

Select Mode（選擇模式）

推薦新手選擇 Quick Start。

Connect Channels（連接平台）

可以選擇綁定你的聊天軟件（如 Telegram），如果只是本地使用，選擇 Skip（跳過）。

Setup AI Providers（配置大模型）

輸入你擁有的大模型 API Key（例如 OpenAI 或 Anthropic 的密鑰）。

Install Daemon（安裝後台服務）

系統會提示是否將 OpenClaw 注冊為系統後台服務，強烈建議同意，這樣 OpenClaw 就能開機自啟並持續運行。

05常用操作指令汇總

openclaw gateway

核心指令。手動啟動本地 AI 網關服務（如果你沒有配置開機自啟，需要運行此命令來喚醒 API 接口）。

openclaw start

啟動 OpenClaw 的後台守護進程。

openclaw stop

停止後台正在運行的 OpenClaw 服務。

openclaw restart

重啟服務（在修改了配置文件或環境變量後非常有用）。

openclaw status

檢查 OpenClaw 當前的運行狀態（是否在線、占用端口等）。

openclaw logs

實時查看 OpenClaw 的運行日誌，用於排查報錯或查看 AI 的處理過程。

openclaw config

打開並編輯當前的系統配置文件。

06進階與優化指令推薦

1. npm 網絡提速優化

如果你在執行 npm install 時遇到網絡卡頓或超時，可以先配置鏡像源加速下載：

npm config set registry https://registry.npmmirror.com

2. 使用 PM2 進行本地進程守護（可選進階）

如果你覺得 OpenClaw 自帶的 Daemon 不夠穩定，可以使用業界標準的 PM2 來管理它：

# 全局安裝 PM2

npm install -g pm2

# 使用 PM2 啟動 OpenClaw 網關

pm2 start openclaw --name "openclaw-gateway" -- gateway

# 設置 PM2 開機自啟

pm2 startup

pm2 save

3. 本地端口防衝突檢查

OpenClaw 默認會占用某些特定端口（如 3000 或 8080）。如果啟動失敗，可以使用以下指令檢查端口是否被占用：

macOSlsof -i :3000

Windowsnetstat -ano | findstr :3000

需要幫助？

如果安裝過程中遇到任何問題，歡迎直接聯繫我們的本地技術工程師。

WhatsApp 技術支援

OpenClaw 深度解析與本地安裝完整指南