這次給大家?guī)砹薕penClaw安裝全流程，從Node.js環(huán)境準(zhǔn)備到完整OpenClaw安裝配置。無論是Ubuntu還是Windows，都能按照本指南快速完成OpenClaw安裝并成功運(yùn)行。

一、Ubuntu 環(huán)境安裝教程

對于很多開發(fā)者來說，Linux 環(huán)境是運(yùn)行服務(wù)器和后臺服務(wù)的首選。如果你目前還沒有安裝 Ubuntu 系統(tǒng)，或者對 Linux 環(huán)境還比較陌生，完全不用擔(dān)心。你可以先去閱讀一下《安裝篇–Ubuntu24.04.2詳細(xì)安裝教程》這篇文章，跟著教程把基礎(chǔ)的操作系統(tǒng)環(huán)境搭建好之后，再回到這里繼續(xù)往下進(jìn)行。

在 Ubuntu 中，我將全程使用命令行來完成安裝。

第一步：部署 Node.js 基礎(chǔ)運(yùn)行環(huán)境

OpenClaw 對 Node.js 的版本有一定要求，為了保證最佳的兼容性和性能，我們這里強(qiáng)烈推薦安裝 Node.js 22.x 版本。

首先，我們需要下載并執(zhí)行 NodeSource 提供的官方安裝配置腳本，它會自動(dòng)幫我們配置好軟件源：

curl -fsSL https://deb.nodesource.com/setup_22.x | bash -

等待上述腳本的執(zhí)行日志跑完，并且看到成功的提示后，我們就可以直接使用 apt 包管理器來安裝 Node.js 本體了：

apt-get install -y nodejs

安裝的過程根據(jù)你的網(wǎng)絡(luò)情況可能會持續(xù)幾十秒到幾分鐘不等。安裝完成后，我們必須驗(yàn)證一下環(huán)境是否真的搭建成功。在終端中輸入查看版本的命令：

node -v

如果你在屏幕上看到了類似于 v22.22.1 這樣的版本號輸出，那么恭喜你，最關(guān)鍵的地基已經(jīng)打好了。

第二步：全局安裝 OpenClaw

接著我們需要把 OpenClaw 安裝到全局環(huán)境中，這樣你在任何目錄下都可以直接用它。

在終端中執(zhí)行以下安裝命令：

npm install -g openclaw@latest

當(dāng)終端提示 added xxx packages 時(shí)，說明所有的依賴包都已經(jīng)下載并解壓完畢。為了確認(rèn)程序可用，我們檢查一下 OpenClaw 的版本信息：

openclaw --version

第三步：初始化向?qū)c大模型配置

OpenClaw 安裝好之后還只是一個(gè)空殼，我們需要給它連接大模型。官方提供了一個(gè)交互式配置向?qū)А?/p>

啟動(dòng)初始化向?qū)Р惭b守護(hù)進(jìn)程：

openclaw onboard --install-daemon

此時(shí)屏幕上會刷出一個(gè)巨大的由字符拼成的 OPENCLAW 圖標(biāo)，并且會彈出一段安全警告。

因?yàn)?OpenClaw 擁有讀取文件和執(zhí)行命令的權(quán)限，系統(tǒng)會詢問你是否了解這是一款默認(rèn)面向個(gè)人的高權(quán)限工具。如果你是在自己的私人機(jī)器或虛擬機(jī)里運(yùn)行，請放心地選擇 Yes 繼續(xù)。

接著選擇向?qū)Ｊ剑瑸榱瞬槐粡?fù)雜的配置項(xiàng)淹沒，我們直接選擇綠色的 QuickStart 模式。

現(xiàn)在到了最核心的一步：選擇大模型供應(yīng)商。針對國內(nèi)的網(wǎng)絡(luò)環(huán)境和性價(jià)比考量，這里我們以 Kimi 為例。使用鍵盤的上下方向鍵，選中 Moonshot AI (Kimi K2.5) 并回車。

認(rèn)證方式我們選擇第一項(xiàng)，即標(biāo)準(zhǔn)的 Kimi API key (.ai)。

系統(tǒng)會詢問你如何提供這個(gè)秘鑰，選擇 Paste API key now，意思是現(xiàn)在直接在終端里粘貼。

在出現(xiàn)的提示行 Enter Moonshot API key 后面，鼠標(biāo)右鍵或者使用快捷鍵粘貼你之前申請好的 API Key，然后按下回車鍵確認(rèn)。

在選擇默認(rèn)模型時(shí)，直接保持選中的 Keep current (moonshot/kimi-k2.5) 不動(dòng)即可。

接下來的幾個(gè)步驟是一些擴(kuò)展功能的配置，為了盡快完成基礎(chǔ)搭建，我們可以暫時(shí)略過：
在選擇 Select channel 時(shí)，移動(dòng)到最下方選擇 Skip for now。

在選擇 Search provider 時(shí)，我們可以順手選擇 Kimi (Moonshot)，讓它具備聯(lián)網(wǎng)搜索的能力。

系統(tǒng)詢問是否現(xiàn)在配置 Configure skills now?，選擇綠色的 No。

詢問是否啟用 Enable hooks?，依然選擇 Skip for now。

經(jīng)過這一系列問答，配置終于完成。終端會打印出 Control UI 的控制臺網(wǎng)址以及專門為你生成的安全訪問 Token。

第四步：啟動(dòng)網(wǎng)關(guān)服務(wù)并進(jìn)入可視化界面

通常配置完成后，我們需要手動(dòng)把網(wǎng)關(guān)服務(wù)跑起來。使用以下命令啟動(dòng)服務(wù)，并指定監(jiān)聽端口為 18789：

openclaw gateway --port 18789

隨后，你會在終端看到不斷刷新的日志，這意味著網(wǎng)關(guān)已經(jīng)成功綁定端口并開始監(jiān)聽請求了。

http://服務(wù)器IP:18789

在地址欄輸入 http://127.0.0.1:18789/（如果是在服務(wù)器上，請把 IP 換成你服務(wù)器的公網(wǎng) IP）。
回車之后，一個(gè)聊天頁面就會呈現(xiàn)在你眼前。你現(xiàn)在可以直接在輸入框里跟你的 AI 助手聊天。

二、Windows 系統(tǒng)環(huán)境安裝

相對于 Linux 的純命令行，Windows 的安裝過程會更加符合普通用戶的直覺，我們將結(jié)合圖形化安裝包和系統(tǒng)命令行來共同完成部署。

第一步：下載并安裝 Node.js 運(yùn)行庫

不管是在什么系統(tǒng)上，打好 Node.js 這個(gè)地基永遠(yuǎn)是第一步。

首先，打開你的瀏覽器，訪問 Node.js 的官方網(wǎng)站主頁，點(diǎn)擊屏幕中央非常醒目的綠色大按鈕 Get Node.js。

頁面跳轉(zhuǎn)后，由于你是 Windows 用戶，直接點(diǎn)擊左側(cè)的 Windows Installer (.msi) 按鈕，下載對應(yīng)的安裝包到你的本地電腦上。

找到剛才下載好的 .msi 后綴的安裝文件，雙擊啟動(dòng)它。在歡迎界面的右下角，直接點(diǎn)擊 Next。

閱讀最終用戶許可協(xié)議，勾選左下角的 I accept the terms in the License Agreement，然后繼續(xù)點(diǎn)擊 Next。

接下來是選擇安裝路徑?？梢渣c(diǎn)擊 Change 按鈕修改到 D 盤或者 E 盤，然后點(diǎn)擊 Next。

在 Custom Setup 安裝這個(gè)界面，不需要做任何修改，保持默認(rèn)勾選的所有組件，直接點(diǎn)擊 Next。

當(dāng)你看到名為 Tools for Native Modules 的界面時(shí)，請一定要勾選屏幕中間的那個(gè)框：“Automatically install the necessary tools…” 。如果不勾選這個(gè)，后續(xù)你在安裝某些復(fù)雜的開源庫時(shí)會瘋狂報(bào)錯(cuò)，這能幫你省去無盡的麻煩！勾選完畢后點(diǎn)擊 Next。

一切就緒，點(diǎn)擊 Install 按鈕，靜靜等待進(jìn)度條跑完。

看到 Completed 界面后，點(diǎn)擊 Finish 按鈕結(jié)束整個(gè)圖形化安裝過程。

為了確認(rèn) Node.js 確實(shí)已經(jīng)安裝進(jìn)了你的系統(tǒng)環(huán)境變量中，請按下鍵盤上的 Win + R 快捷鍵，輸入 cmd 并回車調(diào)出黑色命令行窗口。在里面輸入：

node -v

如果能正確打印出類似于 v24.13.0 這樣的版本號，就說明大功告成了。

第二步：在 Windows 終端全局安裝 OpenClaw

請打開 PowerShell 或者 CMD 終端（為了防止權(quán)限問題，強(qiáng)烈建議鼠標(biāo)右鍵選擇“以管理員身份運(yùn)行”）。然后在里面輸入以下命令：

npm i -g openclaw

這個(gè)過程會從遠(yuǎn)端服務(wù)器拉取大量的代碼包，等待一到兩分鐘，直到出現(xiàn) added xxx packages 的字樣，安裝就完成了。

第三步：啟動(dòng)交互式配置向?qū)?/h3>

和 Ubuntu 系統(tǒng)的流程類似，我們也需要告訴 Windows 上的 OpenClaw 它該連接哪家的大模型。

在剛才的終端中輸入初始化命令：

openclaw onboard

認(rèn)真閱讀屏幕上出現(xiàn)的安全風(fēng)險(xiǎn)提示說明，由于我們清楚自己在做什么，果斷選擇綠色的 Yes 繼續(xù)。

在選擇配置模式時(shí)，為了節(jié)省時(shí)間，我們依然選擇第一項(xiàng) QuickStart 快速模式。

這一次，我們換一個(gè)模型供應(yīng)商來演示。使用方向鍵找到并選中 MiniMax，這款模型在處理長文本和邏輯推理方面也有著不俗的表現(xiàn)。

進(jìn)入具體的認(rèn)證方式選擇，為了保證連接的穩(wěn)定性，請選擇帶有國內(nèi)節(jié)點(diǎn)標(biāo)識的 MiniMax M2.5 (CN) 選項(xiàng)。

系統(tǒng)詢問如何輸入 API 秘鑰，選擇 Paste API key now 準(zhǔn)備直接粘貼。

此時(shí)把你在 MiniMax 開放平臺申請的秘鑰文本復(fù)制過來，在終端里右鍵點(diǎn)擊即可粘貼，然后按下回車。

默認(rèn)模型設(shè)置這一步，不需要修改，保持高亮的 Keep current (minimax-cn/MiniMax-M2.5) 選項(xiàng)并回車。

后續(xù)的高級配置選項(xiàng)，針對新手我們先全部跳過，等熟悉了之后再回來研究：
接入渠道選擇 Skip for now。

搜索引擎服務(wù)選擇 Skip for now。

是否配置技能選擇 No。

是否啟用自動(dòng)化鉤子選擇 Skip for now。

等待一會，你會看到 Gateway 網(wǎng)關(guān)服務(wù)已經(jīng)成功安裝，并列出了一系列本地存儲路徑。

第四步：一鍵孵化并訪問 Web 控制臺

向?qū)нM(jìn)行到最后，會問你打算如何孵化你的機(jī)器人。請選擇中間那一項(xiàng) Open the Web UI。

選擇之后，你會看到終端開始瘋狂地吐出各種后臺運(yùn)行日志，這表明你的私有大模型網(wǎng)關(guān)正在全力運(yùn)轉(zhuǎn)。

與此同時(shí)，你的 Windows 默認(rèn)瀏覽器會自動(dòng)彈出一個(gè)新標(biāo)簽頁，網(wǎng)址指向 http://127.0.0.1:18789。展現(xiàn)在你面前的便是一個(gè)本地 AI 聊天控制臺。打個(gè)招呼，開始探索 OpenClaw 帶來的無限自動(dòng)化潛能吧！

到此這篇關(guān)于windows&ubuntu下OpenClaw保姆級安裝教程的文章就介紹到這了,更多相關(guān)windows OpenClaw安裝內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論