OpenClaw Windows 啟動與關閉完全指南

本文檔旨在幫助您在 Windows 操作系統(tǒng)上正確啟動、關閉以及卸載 OpenClaw，并詳細說明端口配置等關鍵操作。無論您是初次使用還是需要徹底清理環(huán)境，均可參考本指南。

1. 系統(tǒng)要求

• 操作系統(tǒng)：Windows 10 或 Windows 11（64位）
• 權限：部分操作需要以管理員身份運行 PowerShell 或命令提示符
• 依賴：OpenClaw 已正確安裝（可參考官方安裝文檔）

2. 啟動 OpenClaw

OpenClaw 由兩部分組成：后臺核心服務 Gateway 和可視化操作面板 Dashboard。啟動時需先啟動 Gateway，再根據(jù)需要啟動 Dashboard。

2.1 啟動 Gateway 服務（核心）

打開 PowerShell 或 命令提示符（建議右鍵選擇“以管理員身份運行”），執(zhí)行以下命令：

openclaw gateway --port 18789

• --port 18789：指定服務監(jiān)聽的端口。如果省略此參數(shù)，將使用默認端口 18789。您也可以自定義其他端口（例如 --port 18888），但需確保端口未被占用。

命令執(zhí)行后，終端將顯示服務啟動日志，如看到類似 Gateway is running on http://127.0.0.1:18789 的信息，說明啟動成功。

2.2 啟動 Dashboard 操作面板

保持 Gateway 服務運行，另開一個終端（無需管理員權限）執(zhí)行：

openclaw dashboard

該命令會自動在默認瀏覽器中打開 OpenClaw 的管理界面（通常為 http://127.0.0.1:18789）。您可以通過此界面配置代理、查看任務或與 AI 進行交互。

提示：如果您關閉了瀏覽器，可以手動訪問上述地址重新打開面板。

2.3 設置開機自啟動

若希望 OpenClaw 在每次登錄 Windows 時自動運行，可安裝守護服務（計劃任務）：

openclaw onboard --install-daemon

該命令會創(chuàng)建一個名為 OpenClaw Gateway 的計劃任務，開機后自動啟動 Gateway 服務（使用默認端口 18789）。如需修改自啟動時的端口，可在安裝前通過配置文件或環(huán)境變量設置。

2.4 其他常用命令

• 查看服務狀態(tài)：openclaw gateway status
• 重啟服務：openclaw gateway restart
• 查看幫助：openclaw --help

3. 關閉 OpenClaw

3.1 正常停止服務

在管理員 PowerShell 中執(zhí)行：

openclaw gateway stop

該命令會優(yōu)雅地停止 Gateway 服務，釋放占用的端口和資源。

3.2 強制終止進程

如果停止命令無響應，可手動結束進程：

1. 打開任務管理器（Ctrl + Shift + Esc）。
2. 在“進程”列表中找到 openclaw.exe 或 node.exe（與 OpenClaw 相關）。
3. 選中進程，點擊“結束任務”。

3.3 禁用開機自啟動

如果您之前安裝了開機自啟動，現(xiàn)在想關閉它，請執(zhí)行以下命令刪除計劃任務：

schtasks /Delete /F /TN "OpenClaw Gateway"

或通過圖形界面操作：

1. 按 Win + R，輸入 taskschd.msc 打開“任務計劃程序”。
2. 在左側導航欄選擇“任務計劃程序庫”。
3. 找到 OpenClaw Gateway 任務，右鍵點擊選擇“禁用”或“刪除”。

4. 徹底卸載 OpenClaw

如需從系統(tǒng)中完全移除 OpenClaw，請按順序執(zhí)行以下步驟。

4.1 使用官方卸載命令

在管理員 PowerShell 中執(zhí)行以下命令（自動停止服務并清理組件）：

openclaw uninstall --all --yes --non-interactive

• --all：卸載所有組件
• --yes：跳過確認提示
• --non-interactive：非交互模式

4.2 通過控制面板卸載

1. 打開“控制面板” > “程序” > “程序和功能”。
2. 在列表中找到 OpenClaw，右鍵點擊選擇“卸載”。

4.3 手動清理殘留文件

卸載后，建議手動刪除以下可能殘留的文件夾（將 <你的用戶名> 替換為實際用戶名）：

• 主程序安裝目錄
• C:\Program Files\OpenClaw\
• C:\Program Files (x86)\OpenClaw\
• 用戶數(shù)據(jù)目錄
• C:\Users\<你的用戶名>\AppData\Roaming\OpenClaw\
• C:\Users\<你的用戶名>\AppData\Local\OpenClaw\
• 啟動腳本目錄（隱藏文件夾）
• %USERPROFILE%\.openclaw\

可在文件資源管理器地址欄直接粘貼此路徑訪問。

4.4 清理注冊表（可選）

?? 注意：修改注冊表有風險，操作前請務必備份注冊表或創(chuàng)建系統(tǒng)還原點。

1. 按 Win + R，輸入 regedit 打開注冊表編輯器。
2. 按 Ctrl + F，搜索 OpenClaw。
3. 找到相關的項（文件夾），右鍵點擊選擇“刪除”。
4. 按 F3 繼續(xù)查找下一個，直至搜索完畢。

5. 端口配置詳解

5.1 指定端口的方法

OpenClaw 的 Gateway 服務支持通過以下幾種方式指定監(jiān)聽端口：

• 命令行參數(shù)（優(yōu)先級最高）
• openclaw gateway --port 18888
• 環(huán)境變量

$env:OPENCLAW_GATEWAY_PORT=18888
openclaw gateway

• 配置文件
• 在 OpenClaw 的配置文件（如 config.yaml）中設置：

gateway:
  port: 18888

默認值
若以上均未指定，則使用 18789。

5.2 端口優(yōu)先級規(guī)則

端口配置的優(yōu)先級從高到低為：

1. 命令行 --port 參數(shù)
2. 環(huán)境變量 OPENCLAW_GATEWAY_PORT
3. 配置文件中的 gateway.port
4. 內(nèi)置默認值 18789

建議：日常使用直接通過命令行指定端口最為直觀；若需長期固定端口，可在環(huán)境變量或配置文件中設置。

6. 常見問題

Q1：啟動 Gateway 時提示“端口已被占用”怎么辦？
A：使用 netstat -ano | findstr :18789 查看占用端口的進程 PID，然后在任務管理器中結束該進程，或更換其他端口啟動 OpenClaw。

Q2：Dashboard 無法打開網(wǎng)頁？
A：確認 Gateway 已成功啟動且端口正確；檢查防火墻是否阻止了該端口，可嘗試暫時關閉防火墻測試。

Q3：如何在不安裝的情況下臨時使用 OpenClaw？
A：OpenClaw 通常為免安裝版本，直接解壓后即可運行命令。確保已將 OpenClaw 所在目錄添加到系統(tǒng) PATH 環(huán)境變量，或直接在解壓目錄下打開終端執(zhí)行命令。

Q4：開機自啟動設置后未生效？
A：檢查計劃任務是否被安全軟件禁用；可手動運行計劃任務測試，或在任務計劃程序中查看“觸發(fā)條件”是否正確（應設置為“用戶登錄時”）。

© 2026 OpenClaw Windows 使用指南 | 更新日期：2026-03-19
如發(fā)現(xiàn)文檔與您使用的 OpenClaw 版本存在差異，請以官方最新文檔為準。

到此這篇關于OpenClaw Windows 啟動與關閉全流程的文章就介紹到這了,更多相關OpenClaw Windows 啟動內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！

最新評論