廣東
Windows 11系統(tǒng)OpenClaw（龍蝦）安裝教程｜保姆級一步到位
OpenClaw是一款能真正落地執(zhí)行任務(wù)的開源 AI 智能體，可幫你處理郵件、管理日程、自動簽到、對接聊天軟件，全程在本地運(yùn)行，隱私更安全。
本文基于 Windows 11 環(huán)境，把安裝、配置、啟動全流程拆到最簡，新手照著做就能成功。
一、安裝前準(zhǔn)備（必做）
OpenClaw 依賴Git與Node.js運(yùn)行，先裝好這兩個基礎(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)下一步，無需修改配置。
2.安裝 Node.js
下載地址：https://nodejs.org/
安裝要點(diǎn)：選擇LTS 穩(wěn)定版，默認(rèn)安裝，自動配置環(huán)境變量。
OpenClaw 要求 Node.js 版本必須 ≥ 22
3.驗證環(huán)境
以管理員身份打開 CMD，輸入：
git --version
node -v
npm -v出現(xiàn)版本號即環(huán)境正常。
二、安裝 OpenClaw 核心程序
這一步是關(guān)鍵，必須用管理員權(quán)限 CMD，且確保能正常訪問 GitHub。
1. 打開管理員 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? 安裝成功：提示更新若干包，無報錯。
? 安裝失?。╟ode 128）：多執(zhí)行幾次命令，多為網(wǎng)絡(luò)波動導(dǎo)致。
openclaw --version解決報錯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 : 無法加載文件 D:\Program Files\nodejs\npm.ps1，因為在此系統(tǒng)上禁止運(yùn)行腳本。有關(guān)詳細(xì)信息，請參閱 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)過一段時間的安裝
安裝成功
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的版本號，說明安裝成功。
三、初始化配置與啟動
安裝完成后，進(jìn)行初始化配置，綁定 AI 模型并啟動服務(wù)。
1.執(zhí)行初始化命令
openclaw onboard --install-daemon協(xié)議確認(rèn)：選Yes
3.安裝模式：QuickStart4.配置處理：Use existing values
5.模型選擇：新手推薦QwenMoonshot AI (Kimi K2.5)
6.API 方式
選對應(yīng)平臺的 API Key，直接粘貼
7.通訊渠道
選Skip for now（后續(xù)可再加）
8.技能依賴
全部Skip for now
9.各類 API Key
統(tǒng)一選No
10.網(wǎng)關(guān)服務(wù)
Skip
啟動服務(wù)
11.配置完成后，選擇
Open the Web UI
，瀏覽器自動打開本地面板：
http://127.0.0.1:18789/chat如果需要驗證去配置文件中查找
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看到面板顯示版本號 + 健康狀況正常，即為完全啟動成功。
四、常見問題與注意事項
1. 安裝報錯 code 128：重試命令、檢查網(wǎng)絡(luò)、確認(rèn) Git 已裝好。
2. 啟動后無面板：重新執(zhí)行初始化命令，確保端口 18789 未被占用。
3. 模型不生效：檢查 API Key 是否正確，選擇國內(nèi)節(jié)點(diǎn)更穩(wěn)定。
4. 運(yùn)行更穩(wěn)定：官方建議搭配WSL2使用，原生 Windows 偶有兼容問題。
OpenClaw 是輕量化、強(qiáng)執(zhí)行的本地 AI 助手，Windows 11 按 “裝環(huán)境→裝主程序→初始化→啟 WebUI” 四步走，5–10 分鐘就能完成部署。配置時盡量默認(rèn)，減少出錯概率，先用基礎(chǔ)功能，熟悉后再擴(kuò)展渠道與技能。
特別聲明：以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺“網(wǎng)易號”用戶上傳并發(fā)布，本平臺僅提供信息存儲服務(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.
