🚀 OpenClaw 極速安裝與全流程避坑指南：從零到完美運行

OpenClaw 憑藉其強大的 AI 自動化能力最近非常火爆。但在 Windows 環境下安裝，如果不注意細節，很容易在“第一步”就卡死。本文總結了一套從底層環境搭建到後台服務運行的極速流程，適合所有想體驗 OpenClaw 的朋友。

🛠️ 一、 安裝前的“地基”準備（必看！）

很多朋友安裝報錯 ENOENT 或 Permission denied，其實是基礎環境沒配好。

1. 安裝 Node.js (推薦使用 nvm)

OpenClaw 需 Node.js >= 22 版本。Windows 用户推薦使用 nvm 管理 node 版本，這樣切換和管理更方便。

安裝成功後請使用 管理員權限 打開 PowerShell，輸入 nvm -v 驗證。

2. 必須安裝 Git

OpenClaw 許多組件需要 Git 拉取。輸入 git --version 驗證，沒裝請先去官網下載。

3. 配置鏡像源與解決認證問題

國內環境下，設置 npm 鏡像並強制 Git 走 HTTPS（避開 SSH 認證報錯）是極速安裝的關鍵：

# 設置 npm 鏡像
npm config set registry https://registry.npmmirror.com
# 強制 Git 走 HTTPS 協議
git config --global url."https://github.com/".insteadOf git@github.com:

📦 二、 極速安裝步驟

推薦使用 npm 全局安裝，這是最省心的方式：

# 如果之前裝過但報錯，建議先清緩存
npm cache clean --force
# 全局安裝
npm install -g openclaw@latest

安裝完成後，輸入 openclaw --version 看到版本號即代表本體安裝成功。

🛡️ 三、 初始化配置（避坑精華）

這是最關鍵的一步！ 必須解決“權限”和“認證”問題。

1. 以管理員身份運行 PowerShell

右鍵選擇“以管理員身份運行”。否則會導致後台服務安裝失敗，網頁控制枱打不開。

2. 執行引導指令

openclaw onboard --install-daemon

一路選擇 Yes 和 QuickStart。

3. Kimi 用户劃重點：Key 選哪個？

如果你用的是 Kimi，這一步千萬別選錯：

• Auth Method：務必選 Kimi Code API key (subscription)（對應 Kimi Code 訂閲頁面生成的 Key）。
  
• 輸入 Key：粘貼你獲取到的 API Key。
  
• Model：推薦選 kimi-coding/k2p5，這是目前的旗艦模型，響應最快。
  

4. 關於 Telegram 和其他配置

由於網絡環境原因，Telegram 建議先跳過。等頁面能開了再在網頁端配置代理，否則配置過程中會一直報網絡錯誤。

🌐 四、 啓動與訪問

完成配置後，系統會自動安裝後台服務（Daemon）。

• 訪問地址：http://127.0.0.1:18789/
  
• 驗證運行：關掉終端窗口，如果網頁依然能正常聊天，説明後台服務安裝成功！
  
  

⌨️ 五、 OpenClaw 常用指令大全

熟練使用這些指令，能幫你解決 99% 的問題：

1. 服務管理 (Daemon)

• openclaw daemon status：查看後台服務是否正在運行。
• openclaw daemon start：手動啓動後台服務。
• openclaw daemon stop：停止後台服務。
• openclaw daemon restart：重啓服務（修改配置後常用）。

2. 狀態與診斷

• openclaw status：查看當前配置的所有通道和狀態。
• openclaw doctor --fix：【強力推薦】 自動掃描並修復不合法的配置文件。

3. 配置管理

• openclaw onboard：想換模型、換 Key 或重新初始化時使用。

💡 結語

只要搞定了 Git 環境 和 管理員權限，OpenClaw 的體驗非常絲滑。希望這份指南能幫你快速通關，開啓你的 AI 自動化之旅！