一、OpenClaw 簡介

1.1 什么是 OpenClaw

OpenClaw（曾用名 Clawdbot、Moltbot）是一款由奧地利程序員彼得?斯坦伯格（Peter Steinberger）開發(fā)的開源 AI 智能體執(zhí)行框架，于 2025 年 11 月首次發(fā)布，2026 年 1 月正式定名為 OpenClaw。因其圖標(biāo)為龍蝦，在中文社區(qū)中常被親切地稱為 "小龍蝦"。

OpenClaw 不是聊天機器人，也不是大模型本身，而是給 AI 裝上手腳，讓 AI 真正動手干活的數(shù)字執(zhí)行引擎。它是一個運行在你自己設(shè)備上的多渠道 AI 網(wǎng)關(guān)，讓你的 AI 助手能夠無處不在。

1.2 核心功能與用途

• 自主執(zhí)行任務(wù)：理解自然語言指令，直接操作電腦完成真實任務(wù)
• 多渠道通信：支持 Telegram、WhatsApp、Slack、Discord、iMessage、Signal、飛書、企微、QQ 等多個消息平臺
• 本地優(yōu)先：完全運行在你的設(shè)備上，保護數(shù)據(jù)隱私
• 文件管理：自動整理、分類、重命名本地文件
• 瀏覽器自動化：網(wǎng)頁瀏覽、表單填寫、數(shù)據(jù)抓取
• 工作流自動化：在多個應(yīng)用間自動完成復(fù)雜工作流程
• 可擴展架構(gòu)：支持自定義技能（Skill）和插件開發(fā)
• 持久記憶：具備長期記憶能力，持續(xù)學(xué)習(xí)你的使用習(xí)慣

二、環(huán)境準(zhǔn)備

2.1 Windows 11 系統(tǒng)要求

表格

重要提示：Windows 10 系統(tǒng)也可安裝，但本教程專門針對 Windows 11 優(yōu)化

2.2 必要前置依賴軟件

表格

2.3 各依賴軟件詳細(xì)安裝步驟

2.3.1 安裝 Node.js（核心依賴）

Node.js 是 OpenClaw 運行的核心環(huán)境，版本要求極其嚴(yán)格，必須使用 v22.16 或更高版本。

安裝步驟：

1. 訪問 Node.js 官網(wǎng)：https://nodejs.org/zh-cn/download/current/
2. 下載 Windows Installer (.msi) 64 位版本（選擇 v24.x LTS 版本）
3. 雙擊運行安裝程序，按照向?qū)瓿砂惭b
4. 重要：安裝時務(wù)必勾選 "Automatically install the necessary tools" 選項
5. 安裝完成后，重啟電腦
6. 驗證安裝：

node --version
npm --version

應(yīng)顯示：v24.x.x 和 10.x.x

? 禁止使用：Node.js 20.x 及以下版本，會直接導(dǎo)致安裝失敗

2.3.2 安裝 Git

安裝步驟：

1. 訪問 Git 官網(wǎng)：https://git-scm.com/download/win
2. 下載 64-bit Git for Windows Setup
3. 運行安裝程序，全部使用默認(rèn)設(shè)置即可
4. 驗證安裝

git --version

2.3.3 安裝 Visual Studio Build Tools（編譯工具鏈）

這是最容易被忽略但至關(guān)重要的一步，用于編譯原生 C++ 模塊。

安裝步驟：

1. 訪問：https://visualstudio.microsoft.com/zh-hans/downloads/
2. 下載 "Build Tools for Visual Studio 2022"
3. 運行安裝程序，勾選以下工作負(fù)載：
   • ? 使用 C++ 的桌面開發(fā)（Desktop development with C++）
4. 在右側(cè)詳細(xì)組件中，確保勾選：
   • ? MSVC v143 - VS 2022 C++ x64/x86 生成工具
   • ? Windows 11 SDK
   • ? C++ CMake 工具
5. 點擊安裝，等待完成（約 5-10 分鐘）

快速安裝命令（管理員 PowerShell）：

winget install Microsoft.VisualStudio.2022.BuildTools

2.3.4 安裝 Python

安裝步驟：

1. 訪問：https://www.python.org/downloads/windows/
2. 下載 Python 3.11.x（推薦，3.12 也可）
3. 重要：安裝時勾選 "Add Python to PATH"
4. 選擇 "Install Now" 完成安裝
5. 驗證安裝：

python --version

2.3.5 安裝 pnpm 包管理器

pnpm 比 npm 更快、更節(jié)省磁盤空間。

安裝命令（管理員 PowerShell）：

npm install -g pnpm

配置國內(nèi)鏡像（加速下載，強烈推薦）：

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

驗證安裝：

pnpm --version

三、OpenClaw 完整安裝步驟

3.1 方式一：一鍵腳本安裝（推薦新手）

這是最簡單的安裝方式，腳本會自動檢測并配置所有環(huán)境。

步驟：

以管理員身份打開 PowerShell

• 點擊開始菜單
• 搜索 "PowerShell"
• 右鍵點擊 "Windows PowerShell"
• 選擇 "以管理員身份運行"

配置 PowerShell 執(zhí)行策略

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

提示時輸入 Y 確認(rèn)

運行一鍵安裝腳本

iwr -useb https://openclaw.ai/install.ps1 | iex

等待安裝完成（約 2-5 分鐘）

3.2 方式二：源碼編譯安裝（推薦開發(fā)者）

適合需要自定義修改或二次開發(fā)的用戶。

3.2.1 獲取源碼

# 創(chuàng)建安裝目錄
mkdir C:\openclaw
cd C:\openclaw

# 克隆官方倉庫（GitHub）
git clone https://github.com/openclaw/openclaw.git .

# 國內(nèi)用戶可使用 Gitee 鏡像加速
# git clone https://gitee.com/openclaw/openclaw.git .

3.2.2 安裝項目依賴

# 進入項目目錄
cd C:\openclaw

# 配置國內(nèi)鏡像（如未配置）
pnpm config set registry https://registry.npmmirror.com

# 安裝所有依賴
pnpm install

此步驟約需 3-8 分鐘，取決于網(wǎng)絡(luò)速度

3.2.3 編譯構(gòu)建項目

# 構(gòu)建前端 UI 界面
pnpm ui:build
# 構(gòu)建核心服務(wù)
pnpm build

3.2.4 全局鏈接（創(chuàng)建命令）

# 創(chuàng)建全局命令鏈接
npm link

四、安裝驗證與初始化配置

4.1 驗證安裝成功

# 檢查版本
openclaw --version

# 運行系統(tǒng)診斷（最重要的驗證步驟）
openclaw doctor

成功標(biāo)志：所有檢查項均顯示綠色通過

4.2 初始化配置（Onboarding）

# 啟動引導(dǎo)式配置
openclaw onboard

配置向?qū)龑?dǎo)你完成：

1. 選擇 AI 模型提供商（Anthropic、OpenAI、Qwen 等）
2. 輸入對應(yīng)的 API Key
3. 選擇消息渠道（Web UI、Telegram、Discord 等）
4. 設(shè)置 AI 助手名稱和個性

跳過自動啟動 UI：

openclaw onboard --no-ui

4.3 啟動 OpenClaw 服務(wù)

# 啟動 Gateway 服務(wù)（后臺運行）
openclaw gateway start

# 查看服務(wù)狀態(tài)
openclaw gateway status

# 查看運行日志
openclaw logs

4.4 訪問 Web 控制面板

服務(wù)啟動后，在瀏覽器中訪問：

http://localhost:8787

即可打開 OpenClaw 的 Web 管理界面。

五、環(huán)境配置與路徑設(shè)置

5.1 環(huán)境變量配置

OpenClaw 支持通過環(huán)境變量進行高級配置：

臨時設(shè)置（當(dāng)前會話有效）：

$env:SHARP_IGNORE_GLOBAL_LIBVIPS = "1"

永久設(shè)置（用戶級）：

[Environment]::SetEnvironmentVariable("SHARP_IGNORE_GLOBAL_LIBVIPS", "1", "User")

5.2 Node.js 多版本管理（可選）

如果系統(tǒng)中有多個 Node.js 版本，推薦使用 nvm-windows：

1. 下載 nvm-windows：https://github.com/coreybutler/nvm-windows/releases
2. 安裝后執(zhí)行：

nvm install 24
nvm use 24

六、常見問題排查與解決方案

6.1 Node.js 版本相關(guān)問題

問題 1：node --version 顯示版本過低

錯誤：OpenClaw requires Node.js >= 22.16.0

解決方案：

# 1. 卸載舊版本 Node.js
# 2. 下載安裝 v24.x LTS
# 3. 重啟電腦后驗證
node --version

6.2 依賴安裝失敗問題

問題 2：pnpm install 網(wǎng)絡(luò)超時或失敗

解決方案：

# 1. 配置國內(nèi)鏡像
pnpm config set registry https://registry.npmmirror.com

# 2. 清理緩存后重試
pnpm store prune
pnpm install

6.3 編譯工具鏈問題

問題 3：sharp 模塊編譯失敗

錯誤：node-gyp build failed

解決方案：

# 設(shè)置環(huán)境變量跳過 libvips 編譯
$env:SHARP_IGNORE_GLOBAL_LIBVIPS = "1"

# 重新安裝
pnpm install

問題 4：缺少 C++ 編譯工具

錯誤：MSBUILD : error MSB3428: 未能加載 Visual C++ 組件 "VCBuild.exe"

解決方案：

1. 確保已安裝 Visual Studio Build Tools
2. 勾選 "使用 C++ 的桌面開發(fā)" 工作負(fù)載
3. 重啟 PowerShell 后重試

6.4 權(quán)限問題

問題 5：權(quán)限被拒絕

錯誤：EACCES: permission denied

解決方案：

1. 必須以管理員身份運行 PowerShell
2. 關(guān)閉殺毒軟件臨時防護
3. 檢查文件夾權(quán)限

6.5 端口占用問題

問題 6：端口 8787 被占用

解決方案：

# 查找占用進程
netstat -ano | findstr :8787

# 結(jié)束進程（替換 PID）
taskkill /PID <進程ID> /F

# 或使用其他端口啟動
$env:OPENCLAW_PORT = 8888
openclaw gateway start

6.6 內(nèi)存不足問題

問題 7：構(gòu)建過程中內(nèi)存溢出

plaintext

錯誤：JavaScript heap out of memory

解決方案：

# 增加 Node.js 內(nèi)存限制
$env:NODE_OPTIONS = "--max-old-space-size=4096"

# 重新構(gòu)建
pnpm build

七、使用示例與測試方法

7.1 基礎(chǔ)功能驗證

測試 1：命令行對話

# 進入對話模式
openclaw chat

輸入：你好，請介紹一下你自己 預(yù)期：AI 助手正?；貜?fù)

測試 2：系統(tǒng)命令執(zhí)行

# 執(zhí)行簡單命令
openclaw exec "echo 'Hello OpenClaw!'"

測試 3：健康檢查

# 完整系統(tǒng)診斷
openclaw doctor

7.2 簡單使用示例

示例 1：文件整理任務(wù)

在 Web UI 或聊天中發(fā)送：

幫我整理下載文件夾，按文件類型分類，創(chuàng)建文檔、圖片、視頻三個子文件夾，然后把對應(yīng)文件移動進去

預(yù)期結(jié)果：OpenClaw 自動執(zhí)行文件整理操作

示例 2：信息查詢

發(fā)送：

現(xiàn)在幾點了？今天是星期幾？

預(yù)期：返回準(zhǔn)確的時間信息

示例 3：簡單計算

發(fā)送：

計算 256 × 1024 等于多少

預(yù)期：返回正確的計算結(jié)果 262144

7.3 技能（Skill）測試

# 查看已安裝的技能
openclaw skill list

# 運行內(nèi)置技能示例
openclaw skill run system-info

# 安裝新技能（示例）
openclaw skill install weather

7.4 服務(wù)管理常用命令

# 啟動服務(wù)
openclaw gateway start

# 停止服務(wù)
openclaw gateway stop

# 重啟服務(wù)
openclaw gateway restart

# 查看狀態(tài)
openclaw gateway status

# 查看實時日志
openclaw logs -f

# 更新 OpenClaw
openclaw update

八、后續(xù)建議

1. 首次使用：建議先從簡單任務(wù)開始，逐步熟悉 OpenClaw 的能力
2. API Key 配置：確保配置了有效的大模型 API Key，這是 AI 功能正常工作的前提
3. 數(shù)據(jù)備份：定期備份 %USERPROFILE%\.openclaw 目錄
4. 關(guān)注更新：OpenClaw 迭代很快，定期運行 openclaw update 更新
5. 社區(qū)支持：遇到問題可訪問 GitHub Issues 或中文社區(qū)尋求幫助

恭喜！ 你已成功完成 OpenClaw 的安裝與配置。現(xiàn)在你擁有了一個可以真正幫你干活的 AI 私人助理！

如有任何問題，建議先運行 openclaw doctor 進行自我診斷，大部分問題都能自動檢測并給出修復(fù)建議。

以上就是Windows 11操作系統(tǒng)安裝OpenClaw的完整教程的詳細(xì)內(nèi)容，更多關(guān)于Windows 11安裝OpenClaw教程的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論