1. 啟動(dòng)配置向?qū)?/h3>

\# 啟動(dòng)向?qū)Р惭b后臺(tái)守護(hù)進(jìn)程（開(kāi)機(jī)自啟）
openclaw onboard --install-daemon

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

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

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

1. 配置 GLM-4.6（重點(diǎn)步驟）：

• 輸入智譜 AI API Key（從 智譜開(kāi)放平臺(tái) 獲取：注冊(cè)→登錄→API 密鑰管理→創(chuàng)建密鑰）；
• 輸入 Base URL：https://open.bigmodel.cn/api/anthropic；
• 輸入模型名稱(chēng)：glm-4.6（區(qū)分大小寫(xiě)，不可修改）；

1. 配置聊天平臺(tái)（可選）：可連接 Telegram、Discord 等，新手可直接跳過(guò)；
2. 安裝后臺(tái)守護(hù)進(jìn)程：

• macOS：自動(dòng)配置 launchd，支持開(kāi)機(jī)自啟；
• Linux/WSL2：自動(dòng)配置 systemd，支持開(kāi)機(jī)自啟；
• Windows：自動(dòng)配置系統(tǒng)服務(wù)，后臺(tái)運(yùn)行。

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

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

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

四、啟動(dòng)與驗(yàn)證

1. 啟動(dòng) OpenClaw 服務(wù)

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

2. 驗(yàn)證 GLM-4.6 模型

服務(wù)啟動(dòng)后，終端會(huì)顯示 Web 控制臺(tái)地址（默認(rèn)：http://localhost:3000），瀏覽器打開(kāi)后：

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

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

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

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

六、常見(jiàn)問(wèn)題排查（避坑指南）

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

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

2. sharp 依賴安裝失?。╩acOS 常見(jiàn)）

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

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

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

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

• 查看端口占用：

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

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

5. 配置不生效

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

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

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

七、總結(jié)

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

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

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

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