廣東
Windows 11系統(tǒng)OpenClaw（龍蝦）安裝教程｜保姆級(jí)一步到位
OpenClaw是一款能真正落地執(zhí)行任務(wù)的開(kāi)源 AI 智能體，可幫你處理郵件、管理日程、自動(dòng)簽到、對(duì)接聊天軟件，全程在本地運(yùn)行，隱私更安全。
本文基于 Windows 11 環(huán)境，把安裝、配置、啟動(dòng)全流程拆到最簡(jiǎn)，新手照著做就能成功。
一、安裝前準(zhǔn)備（必做）
OpenClaw 依賴Git與Node.js運(yùn)行，先裝好這兩個(gè)基礎(chǔ)環(huán)境。
1.安裝 Git
下載地址：https://github.com/git-for-windows/git/releases/download/v2.52.0.windows.1/Git-2.52.0-64-bit.exe
安裝要點(diǎn)：全程默認(rèn)下一步，無(wú)需修改配置。
2.安裝 Node.js
下載地址：https://nodejs.org/
安裝要點(diǎn)：選擇LTS 穩(wěn)定版，默認(rèn)安裝，自動(dòng)配置環(huán)境變量。
OpenClaw 要求 Node.js 版本必須 ≥ 22
3.驗(yàn)證環(huán)境
以管理員身份打開(kāi) CMD，輸入：
git --version
node -v
npm -v出現(xiàn)版本號(hào)即環(huán)境正常。
二、安裝 OpenClaw 核心程序
這一步是關(guān)鍵，必須用管理員權(quán)限 CMD，且確保能正常訪問(wèn) GitHub。
1. 打開(kāi)管理員 CMD
路徑：控制面板 → 系統(tǒng)和安全 → Windows 工具 → 找到命令提示符→ 右鍵以管理員身份運(yùn)行。
2. 執(zhí)行安裝命令
參考https://docs.openclaw.ai/zh-CN/install
iwr -useb https://openclaw.ai/install.ps1 | iex
或者
npm i -g openclaw --ignore-scripts --registry=https://registry.npmmirror.comnpm i -g openclaw --ignore-scripts --registry=https://registry.npmmirror.com? 安裝成功：提示更新若干包，無(wú)報(bào)錯(cuò)。
? 安裝失?。╟ode 128）：多執(zhí)行幾次命令，多為網(wǎng)絡(luò)波動(dòng)導(dǎo)致。
openclaw --version解決報(bào)錯(cuò)PS C:\Users\Administrator> iwr -useb https://openclaw.ai/install.ps1 | iex
OpenClaw Installer
[OK] Windows detected
[OK] Node.js v24.14.0 found
[*] Installing OpenClaw (openclaw@latest)...
iex : 無(wú)法加載文件 D:\Program Files\nodejs\npm.ps1，因?yàn)樵诖讼到y(tǒng)上禁止運(yùn)行腳本。有關(guān)詳細(xì)信息，請(qǐng)參閱 https:/go.microsof
t.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。
所在位置 行:1 字符: 45
iwr -useb https://openclaw.ai/install.ps1 | iex
~~~CategoryInfo : SecurityError: (:) [Invoke-Expression]，PSSecurityException
FullyQualifiedErrorId : UnauthorizedAccess,Microsoft.PowerShell.Commands.InvokeExpressionCommand
設(shè)置執(zhí)行策略為 RemoteSigned（允許運(yùn)行本地腳本，遠(yuǎn)程腳本需簽名）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
經(jīng)過(guò)一段時(shí)間的安裝
安裝成功
PS C:\Users\Administrator> iwr -useb https://openclaw.ai/install.ps1 | iex
OpenClaw Installer
[OK] Windows detected
[OK] Node.js v24.14.0 found
[*] Installing OpenClaw (openclaw@latest)...
[OK] OpenClaw installed
OpenClaw installed successfully (2026.3.2)!
Cozy. I've already read your calendar. We need to talk.
Starting setup...
OpenClaw 2026.3.2 (85377a2) — I autocomplete your thoughts—just slower and with more API calls.
Windows detected — OpenClaw runs great on WSL2!
Native Windows might be trickier.
Quick setup: wsl --install (one command, one reboot)
Guide: https://docs.openclaw.ai/windows
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██?▄▄▄?██?▄▄?██?▄▄▄██??██?██?▄▄?██?████?▄▄?██?███?██
██?███?██????██?▄▄▄██?█?█?██?█████?████????██?█?█?██
██?????██?█████????██?██▄?██???▄██????█?██?██▄?▄?▄██
????????????????????????????????????????????????????
OPENCLAWT OpenClaw onboarding
|
o Security ---------------------------------------------------------------------------------+
| |
| Security warning — please read. |
| |
| OpenClaw is a hobby project and still in beta. Expect sharp edges. |
| By default, OpenClaw is a personal agent: one trusted operator boundary. |
| This bot can read files and run actions if tools are enabled. |
| A bad prompt can trick it into doing unsafe things. |
| |
| OpenClaw is not a hostile multi-tenant boundary by default. |
| If multiple users can message one tool-enabled agent, they share that delegated tool |
| authority. |
| |
| If you’re not comfortable with security hardening and access control, don’t run |
| OpenClaw. |
| Ask someone experienced to help before enabling tools or exposing it to the internet. |
| |
| Recommended baseline: |
| - Pairing/allowlists + mention gating. |
| - Multi-user/shared inbox: split trust boundaries (separate gateway/credentials, ideally |
| separate OS users/hosts). |
| - Sandbox + least-privilege tools. |
| - Shared inboxes: isolate DM sessions (`session.dmScope: per-channel-peer`) and keep |
| tool access minimal. |
| - Keep secrets out of the agent’s reachable filesystem. |
| - Use the strongest available model for any bot with tools or untrusted inboxes. |
| |
| Run regularly: |
| openclaw security audit --deep |
| openclaw security audit --fix |
| |
| Must read: https://docs.openclaw.ai/gateway/security |
| |
+--------------------------------------------------------------------------------------------+
查看版本
openclaw --versionPS C:\Users\Administrator> openclaw --version
2026.3.2
出現(xiàn)類似2026.3.2的版本號(hào)，說(shuō)明安裝成功。
三、初始化配置與啟動(dòng)
安裝完成后，進(jìn)行初始化配置，綁定 AI 模型并啟動(dòng)服務(wù)。
1.執(zhí)行初始化命令
openclaw onboard --install-daemon協(xié)議確認(rèn)：選Yes
3.安裝模式：QuickStart4.配置處理：Use existing values
5.模型選擇：新手推薦QwenMoonshot AI (Kimi K2.5)
6.API 方式
選對(duì)應(yīng)平臺(tái)的 API Key，直接粘貼
7.通訊渠道
選Skip for now（后續(xù)可再加）
8.技能依賴
全部Skip for now
9.各類 API Key
統(tǒng)一選No
10.網(wǎng)關(guān)服務(wù)
Skip
啟動(dòng)服務(wù)
11.配置完成后，選擇
Open the Web UI
，瀏覽器自動(dòng)打開(kāi)本地面板：
http://127.0.0.1:18789/chat如果需要驗(yàn)證去配置文件中查找
C:\Users\Administrator\.openclaw\config.json
查找"port": 18789,
"mode": "local",
"bind": "loopback",
"auth": {
"mode": "token",
"token": "你的配置的token"
http://127.0.0.1:18789/?token=你的配置的token看到面板顯示版本號(hào) + 健康狀況正常，即為完全啟動(dòng)成功。
四、常見(jiàn)問(wèn)題與注意事項(xiàng)
1. 安裝報(bào)錯(cuò) code 128：重試命令、檢查網(wǎng)絡(luò)、確認(rèn) Git 已裝好。
2. 啟動(dòng)后無(wú)面板：重新執(zhí)行初始化命令，確保端口 18789 未被占用。
3. 模型不生效：檢查 API Key 是否正確，選擇國(guó)內(nèi)節(jié)點(diǎn)更穩(wěn)定。
4. 運(yùn)行更穩(wěn)定：官方建議搭配WSL2使用，原生 Windows 偶有兼容問(wèn)題。
OpenClaw 是輕量化、強(qiáng)執(zhí)行的本地 AI 助手，Windows 11 按 “裝環(huán)境→裝主程序→初始化→啟 WebUI” 四步走，5–10 分鐘就能完成部署。配置時(shí)盡量默認(rèn)，減少出錯(cuò)概率，先用基礎(chǔ)功能，熟悉后再擴(kuò)展渠道與技能。
特別聲明：以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶上傳并發(fā)布，本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
