廣東
Windows 11系統OpenClaw（龍蝦）安裝教程｜保姆級一步到位
OpenClaw是一款能真正落地執行任務的開源 AI 智能體，可幫你處理郵件、管理日程、自動簽到、對接聊天軟件，全程在本地運行，隱私更安全。
本文基于 Windows 11 環境，把安裝、配置、啟動全流程拆到最簡，新手照著做就能成功。
一、安裝前準備（必做）
OpenClaw 依賴Git與Node.js運行，先裝好這兩個基礎環境。
1.安裝 Git
下載地址：https://github.com/git-for-windows/git/releases/download/v2.52.0.windows.1/Git-2.52.0-64-bit.exe
安裝要點：全程默認下一步，無需修改配置。
2.安裝 Node.js
下載地址：https://nodejs.org/
安裝要點：選擇LTS 穩定版，默認安裝，自動配置環境變量。
OpenClaw 要求 Node.js 版本必須 ≥ 22
3.驗證環境
以管理員身份打開 CMD，輸入：
git --version
node -v
npm -v出現版本號即環境正常。
二、安裝 OpenClaw 核心程序
這一步是關鍵，必須用管理員權限 CMD，且確保能正常訪問 GitHub。
1. 打開管理員 CMD
路徑：控制面板 → 系統和安全 → Windows 工具 → 找到命令提示符→ 右鍵以管理員身份運行。
2. 執行安裝命令
參考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? 安裝成功：提示更新若干包，無報錯。
? 安裝失敗（code 128）：多執行幾次命令，多為網絡波動導致。
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，因為在此系統上禁止運行腳本。有關詳細信息，請參閱 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
設置執行策略為 RemoteSigned（允許運行本地腳本，遠程腳本需簽名）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
經過一段時間的安裝
安裝成功
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
出現類似2026.3.2的版本號，說明安裝成功。
三、初始化配置與啟動
安裝完成后，進行初始化配置，綁定 AI 模型并啟動服務。
1.執行初始化命令
openclaw onboard --install-daemon協議確認：選Yes
3.安裝模式：QuickStart4.配置處理：Use existing values
5.模型選擇：新手推薦QwenMoonshot AI (Kimi K2.5)
6.API 方式
選對應平臺的 API Key，直接粘貼
7.通訊渠道
選Skip for now（后續可再加）
8.技能依賴
全部Skip for now
9.各類 API Key
統一選No
10.網關服務
Skip
啟動服務
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：重試命令、檢查網絡、確認 Git 已裝好。
2. 啟動后無面板：重新執行初始化命令，確保端口 18789 未被占用。
3. 模型不生效：檢查 API Key 是否正確，選擇國內節點更穩定。
4. 運行更穩定：官方建議搭配WSL2使用，原生 Windows 偶有兼容問題。
OpenClaw 是輕量化、強執行的本地 AI 助手，Windows 11 按 “裝環境→裝主程序→初始化→啟 WebUI” 四步走，5–10 分鐘就能完成部署。配置時盡量默認，減少出錯概率，先用基礎功能，熟悉后再擴展渠道與技能。
特別聲明：以上內容(如有圖片或視頻亦包括在內)為自媒體平臺“網易號”用戶上傳并發布，本平臺僅提供信息存儲服務。
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.
