1. 啟動配置向?qū)?/h3>

\# 啟動向?qū)Р惭b后臺守護進程（開機自啟）
openclaw onboard --install-daemon

2. 向?qū)渲貌襟E（按終端提示操作）

1. 選擇網(wǎng)關(guān)類型：新手推薦「Local Gateway（本地網(wǎng)關(guān)）」，無需額外服務(wù)器；
2. 選擇 AI 模型提供商：

• 接入 GLM-4.6：選擇「Custom/Other」（自定義模型）；
• 接入 Claude：選擇「Anthropic」，直接輸入 Claude API Key；

1. 配置 GLM-4.6（重點步驟）：

• 輸入智譜 AI API Key（從 智譜開放平臺 獲?。鹤?rarr;登錄→API 密鑰管理→創(chuàng)建密鑰）；
• 輸入 Base URL：https://open.bigmodel.cn/api/anthropic；
• 輸入模型名稱：glm-4.6（區(qū)分大小寫，不可修改）；

1. 配置聊天平臺（可選）：可連接 Telegram、Discord 等，新手可直接跳過；
2. 安裝后臺守護進程：

• macOS：自動配置 launchd，支持開機自啟；
• Linux/WSL2：自動配置 systemd，支持開機自啟；
• Windows：自動配置系統(tǒng)服務(wù)，后臺運行。

3. 配置文件路徑（重要）

后續(xù)修改配置、查看日志可訪問以下路徑：

• 主配置目錄：~/.openclaw/（Linux/macOS/WSL2）、C:\Users\你的用戶名\.openclaw\（Windows）；
• 模型認(rèn)證配置：~/.openclaw/agents/[agentId]/agent/auth-profiles.json；
• 日志文件：~/.openclaw/logs/。

四、啟動與驗證

1. 啟動 OpenClaw 服務(wù)

\# 啟動服務(wù)（后臺運行）
openclaw start
\# 查看服務(wù)狀態(tài)
openclaw status
\# 停止服務(wù)
openclaw stop
\# 重啟服務(wù)（配置修改后需執(zhí)行）
openclaw restart

2. 驗證 GLM-4.6 模型

服務(wù)啟動后，終端會顯示 Web 控制臺地址（默認(rèn)：http://localhost:3000），瀏覽器打開后：

1. 進入「模型測試」頁面；
2. 輸入測試指令：你好，請用 GLM-4.6 介紹自己；
3. 收到包含「GLM-4.6」關(guān)鍵詞的回復(fù)，即表示安裝 + 配置成功。

五、VS Code 插件集成（可選）

在 VS Code 中直接調(diào)用 GLM-4.6 輔助開發(fā)，步驟如下：

1. 打開 VS Code → 擴展面板（Ctrl+Shift+X）；
2. 搜索「OpenClaw」→ 安裝官方插件（Anthropic 認(rèn)證）；
3. 插件會自動讀取 ~/.openclaw/ 目錄下的配置，無需額外設(shè)置；
4. 使用方式：右鍵代碼 → 選擇「OpenClaw：代碼解釋 / 重構(gòu) / 補全」，或使用快捷鍵 Ctrl+Shift+P 調(diào)用命令。

六、常見問題排查（避坑指南）

1. 安裝失敗 / 權(quán)限不足

• Linux/macOS：命令前添加 sudo（如 sudo npm install -g openclaw@latest）；
• Windows：必須以「管理員身份」打開 PowerShell 執(zhí)行安裝腳本；
• npm 權(quán)限報錯：執(zhí)行 sudo chown -R $USER:$GROUP ~/.npm（Linux/macOS）修復(fù)權(quán)限。

2. sharp 依賴安裝失敗（macOS 常見）

\# 方案1：忽略全局 libvips
SHARP\_IGNORE\_GLOBAL\_LIBVIPS=1 npm install -g openclaw@latest
\# 方案2：手動安裝 libvips
brew install vips
npm install -g openclaw@latest

3. GLM-4.6 調(diào)用報錯（401/403 / 模型不存在）

• 檢查 API Key：是否正確、未過期、有 GLM-4.6 調(diào)用權(quán)限；
• 確認(rèn) Base URL：必須為 https://open.bigmodel.cn/api/anthropic（不可多斜杠 / 少斜杠）；
• 模型名稱：嚴(yán)格為 glm-4.6（區(qū)分大小寫）；
• 重啟服務(wù)：openclaw restart 使配置生效。

4. 服務(wù)無法啟動 / 端口占用

• 查看端口占用：

\# Linux/macOS
lsof -i :3000
\# Windows（PowerShell）
netstat -ano | findstr :3000

• 殺死占用進程：kill -9 進程ID（Linux/macOS），或在任務(wù)管理器結(jié)束對應(yīng)進程（Windows）；
• 修改端口：編輯 ~/.openclaw/config.json，修改 port 字段為其他端口（如 3001），重啟服務(wù)。

5. 配置不生效

• 刪除舊配置目錄，重新初始化：

rm -rf \~/.openclaw  # Linux/macOS/WSL2
openclaw onboard --install-daemon

• 重啟終端 / 電腦，確保環(huán)境變量生效。

七、總結(jié)

OpenClaw 安裝核心流程：安裝 Node.js → 選擇安裝方式（一鍵 / 手動 / Docker）→ 初始化配置 GLM-4.6 → 啟動服務(wù)驗證。

• 新手用戶：優(yōu)先選擇「官方一鍵安裝」，全程自動化，無需手動配置；
• 服務(wù)器部署：推薦「Docker 部署」，環(huán)境隔離，穩(wěn)定不污染系統(tǒng)；
• 開發(fā)者：選擇「源碼安裝」，支持二次開發(fā)與功能定制。

配置完成后，即可在本地 Web 控制臺、VS Code 中高效調(diào)用 GLM-4.6，實現(xiàn) AI 輔助開發(fā)、自動化工作流等場景，大幅提升效率～

到此這篇關(guān)于OpenClaw 完整安裝教程詳解(2026最新版,全平臺通用)的文章就介紹到這了,更多相關(guān)OpenClaw安裝教程內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！