30分鐘快速使用OpenClaw(新手入門必看)

發(fā)布時(shí)間：2026-03-13 09:49:43 作者：不脫發(fā)的程序猿

文章介紹了如何使用官方腳本進(jìn)行Windows一鍵安裝OpenClaw,并詳細(xì)說明了環(huán)境依賴準(zhǔn)備、腳本安裝、驗(yàn)證安裝、配置引導(dǎo)、服務(wù)自啟安裝等步驟,最后,還提供了如何關(guān)閉服務(wù)窗口、重新啟動(dòng)服務(wù)和進(jìn)行問答測試的命令，感興趣的朋友跟隨小編一起看看吧

修改策略

使用管理員權(quán)限，打開Windows PowerShell。

先查看PowerShell執(zhí)行策略，只要不是 AllSigned(所有腳本必須有簽名) 就行，RemoteSigned(本地腳本不受簽名限制，遠(yuǎn)程腳本必須有簽名) 與 Restricted(受限)。

Get-ExecutionPolicy

若需要修改策略，可以執(zhí)行Set-ExecutionPolicy。

Set-ExecutionPolicy Restricted

輸出如下：

執(zhí)行策略更改
執(zhí)行策略可幫助你防止執(zhí)行不信任的腳本。更改執(zhí)行策略可能會(huì)產(chǎn)生安全風(fēng)險(xiǎn)，如 https:/go.microsoft.com/fwlink/?LinkID=135170
中的 about_Execution_Policies 幫助主題所述。是否要更改執(zhí)行策略?
[Y] 是(Y) [A] 全是(A) [N] 否(N) [L] 全否(L) [S] 暫停(S) [?] 幫助 (默認(rèn)值為“N”): Y

環(huán)境依賴

準(zhǔn)備環(huán)境。
Node.js 建議使用v22+。

node --version

當(dāng)前版本號(hào)輸出如下：

v22.22.0

Git 也需要安裝。

git --version

當(dāng)前版本號(hào)輸出如下：

git version 2.23.0.windows.1

腳本安裝

執(zhí)行腳本。

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

輸出結(jié)果如下：

  OpenClaw Installer
[OK] Windows detected
[*] Existing OpenClaw installation detected
[OK] Node.js v22.22.0 found
[*] Installing OpenClaw (openclaw@latest)...
[OK] OpenClaw installed
[*] Running doctor to migrate settings...
?? OpenClaw 2026.3.8 (3caab92) — I've seen your commit messages. We'll work on that together.
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██?▄▄▄?██?▄▄?██?▄▄▄██??██?██?▄▄?██?████?▄▄?██?███?██
██?███?██????██?▄▄▄██?█?█?██?█████?████????██?█?█?██
██?????██?█████????██?██▄?██???▄██????█?██?██▄?▄?▄██
????????????????????????????????????????????????????
                  ?? OPENCLAW ??
T  OpenClaw doctor
|
o  Gateway ----------------------------------------------------------+
+--------------------------------------------------------------------+
|
o  Gateway auth -----------------------------------------------------+
+--------------------------------------------------------------------+
|
o  State integrity --------------------------------------------------+
+--------------------------------------------------------------------+
|
o  Security ---------------------------------+
+--------------------------------------------+
|
o  Skills status ------------+
+----------------------------+
|
o  Plugins ------+
+----------------+
|
o  Shell completion -------------------------------------------------+
+--------------------------------------------------------------------+
|
o  Shell completion -------------------------------------------------+
+--------------------------------------------------------------------+
o  Gateway --------------+
+------------------------+
|
o  Gateway connection ---------------------------+
|                                                |
|  Gateway target: ws://127.0.0.1:18789          |
|  Source: local loopback                        |
|  Config: C:\Users\xxx\.openclaw\openclaw.json  |
|  Bind: loopback                                |
|                                                |
+------------------------------------------------+
|
o  Gateway ------------------------+
|                                  |
|  Gateway service not installed.  |
|                                  |
+----------------------------------+
Run "openclaw doctor --fix" to apply changes.
—  Doctor complete.
[OK] Migration complete
OpenClaw installed successfully (OpenClaw 2026.3.8 (3caab92))!

驗(yàn)證命令

查看命令openclaw是否存在。

whereis openclaw

輸出類似如下則表明，基礎(chǔ)環(huán)境已經(jīng)安裝。

openclaw: /xxx/v22.22.0/openclaw /xxx/v22.22.0/openclaw.cmd /xxx/v22.22.0/openclaw.ps1

驗(yàn)證安裝

管理員權(quán)限單開cmd 命令控制行窗口，使用doctor 再次驗(yàn)證是否安裝成功。

openclaw doctor

生成網(wǎng)關(guān)gateway 對應(yīng)的token。

o  Generate and configure a gateway token now?
|  Yes

啟用zsh腳本命令。

*  Enable zsh shell completion for openclaw?
|  Yes

服務(wù)自啟

安裝gateway 服務(wù)。

o  Install gateway service now?
|  Yes

配置服務(wù)運(yùn)行時(shí)。

o  Gateway service runtime
|  Node (recommended)
Installed Scheduled Task: OpenClaw Gateway
Task script: C:\Users\llr\.openclaw\gateway.cmd
Updated ~\.openclaw\openclaw.json
|
—  Doctor complete.

實(shí)際安裝服務(wù)就是創(chuàng)建計(jì)劃任務(wù)，用戶登錄時(shí)就可以啟動(dòng)，可以注銷賬戶，再次登錄系統(tǒng)即可運(yùn)行，當(dāng)前可以繼續(xù)執(zhí)行后續(xù)命令。

新手引導(dǎo)

執(zhí)行控制面板配置引導(dǎo)。

openclaw onboard --install-daemon

為當(dāng)前用戶添加配置。

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
|   Yes

引導(dǎo)面板模式快速開始。

o  Onboarding mode
|  QuickStart
|
o  Existing config detected ---------+
+------------------------------------+

配置處理，使用已經(jīng)存在的值。

o  Config handling
|  Use existing values
|
o  QuickStart -----------------------------+
+------------------------------------------+

模型和驗(yàn)證模型供應(yīng)商，選擇跳過。

o  Model/auth provider
|  Skip for now

過濾模型提供商模型，選擇所有模型。

o  Filter models by provider
|  All providers

默認(rèn)模型，可以先展示使用手動(dòng)輸入，這個(gè)時(shí)候模型還無法正常使用，只是先用于在配置文件中占位，可以先配置默認(rèn)。

o  Default model
|  Enter model manually
|
o  Default model
|  anthropic/claude-opus-4-6
|
o  Model check -----------------------------------+
|  No auth configured for provider "anthropic". The agent may fail until credentials are  |
|  added.                                                                  
+---------------------------------------------+

配置頻道，現(xiàn)在如果不確認(rèn)，可以跳過，后續(xù)再替換。

o  Channel status ----------------------------+
+---------------------------------------------+
|
o  Select channel (QuickStart)
|  Skip for now
o  Web search ----------------------------------------+
+-----------------------------------------------------+

搜索提供器，可以考慮先跳過。

o  Search provider
|  Skip for now
o  Skills status -------------+
+-----------------------------+

配置skills。

o  Configure skills now? (recommended)
|  Yes
|
o  Install missing skill dependencies
|  Skip for now
|
o  Set GOOGLE_PLACES_API_KEY for goplaces?
|  No
|
o  Set GEMINI_API_KEY for nano-banana-pro?
|  No
|
o  Set NOTION_API_KEY for notion?
|  No
|
o  Set ELEVENLABS_API_KEY for sag?
|  No

配置Hook 配置，空格鍵 表示選中和取消，[+] 表示選中，可以都添加并回車提交。

o  Hooks ------------------------------------------------------------------+
+--------------------------------------------------------------------------+
|
o  Enable hooks?
|  ?? boot-md, ?? bootstrap-extra-files, ?? command-logger, ?? session-memory
|
o  Hooks Configured ------------------------------------------------------+
+-------------------------------------------------------------------------+

可以選擇重新啟動(dòng)gateway 服務(wù)，會(huì)彈出新的服務(wù)啟動(dòng)框。

o  Gateway service already installed
|  Restart

服務(wù)啟動(dòng)后，會(huì)有一個(gè)命令行窗口，此時(shí)為前臺(tái)運(yùn)行，這個(gè)窗口不能關(guān)閉，關(guān)閉后服務(wù)就退出了。

服務(wù)訪問

選擇打開Web UI，會(huì)自動(dòng)打開本地默認(rèn)瀏覽器。

o  Optional apps ------------------------+
+----------------------------------------+
o  How do you want to hatch your bot?
|  Open the Web UI
|
+----------------------------------------------------------------------+
—  Onboarding complete. Dashboard opened; keep that tab to control OpenClaw.

頁面展示如下：

環(huán)境變量

如果手抖關(guān)閉掉了，又不想注銷賬戶，可以直接執(zhí)行命令行。

openclaw gateway --port 18789

直接修改配置文件C:\Users\<User>\.openclaw\openclaw.json，修改自己的提供商和模型，詳細(xì)可以參考鏈接。以deepseek 為例，DEEPSEEK_API_KEY 為環(huán)境變量。

配置模型

配置自定義的模型服務(wù)提供商models 與 agents 平級(jí)。

{      
 "models": {
   "mode":"merge",
   "providers": {
	  "deepseek": { 
	    "baseUrl": "https://api.deepseek.com/v1", 
	    "apiKey": "${DEEPSEEK_API_KEY}", 
	    "api": "openai-completions", 
	    "models": [
	    { 
		  "id": "deepseek-chat", 
		  "name": "Deepseek-Chat" 
	    }]
	 },
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      },
      "workspace": "C:\\Users\\<User>\\.openclaw\\workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "tools": {
    "profile": "coding"
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {},
  "session": {},
  "hooks": {},
  "gateway": {}
}

退出當(dāng)前服務(wù)窗口，單開一個(gè)cmd 命令行窗口，執(zhí)行命令重新啟動(dòng)服務(wù)。