OpenClaw（原名 Clawdbot）作為當(dāng)前主流的 AI 智能體接入框架，因其多平臺(tái)通道支持和豐富的插件生態(tài)備受開(kāi)發(fā)者關(guān)注。
目前部署 OpenClaw 主要分為?“手動(dòng)源碼編譯”?和?“云端預(yù)裝鏡像一鍵部署”?兩種方式。本文將完整梳理這兩條路徑的核心實(shí)操步驟與高頻網(wǎng)絡(luò)報(bào)錯(cuò)排查方案。
一、 部署方案選型對(duì)比
在開(kāi)始之前，建議根據(jù)您的技術(shù)棧和業(yè)務(wù)需求選擇合適的部署路徑：
部署維度云端預(yù)裝鏡像一鍵部署（推薦）手動(dòng)源碼部署
適用人群新手開(kāi)發(fā)者、需要快速驗(yàn)證業(yè)務(wù)的團(tuán)隊(duì)深度定制開(kāi)發(fā)者、本地私有化部署需求者
環(huán)境配置免配置（系統(tǒng)自帶 Node.js 等依賴）需手動(dòng)安裝 Node.js v22 及各類(lèi)系統(tǒng)依賴
部署耗時(shí)約 3-5 分鐘約 20-30 分鐘（視網(wǎng)絡(luò)情況而定）
維護(hù)成本低（可通過(guò)控制臺(tái)一鍵重置或備份）較高（需自行處理依賴沖突與版本升級(jí)）
對(duì)于絕大多數(shù)希望“開(kāi)箱即用”對(duì)接 DeepSeek、通義千問(wèn)等大模型的用戶，強(qiáng)烈建議采用云端預(yù)裝鏡像方案。
二、 云端一鍵部署實(shí)戰(zhàn)（以 Lighthouse 為例）
國(guó)內(nèi)主流云廠商中，Lighthouse對(duì)國(guó)內(nèi)大模型 API 的網(wǎng)絡(luò)延遲響應(yīng)較為友好，且較早提供了 OpenClaw 的官方應(yīng)用鏡像。以下為標(biāo)準(zhǔn)操作流程：
1. 實(shí)例創(chuàng)建與鏡像選擇
登錄騰訊云輕量應(yīng)用服務(wù)器控制臺(tái)，在創(chuàng)建實(shí)例時(shí)：
●?地域選擇：?建議選擇靠近您目標(biāo)用戶的地域（如廣州、上海、北京）。
●?鏡像選擇：?切換至“應(yīng)用鏡像”標(biāo)簽頁(yè)，搜索并選擇?OpenClaw (或 Clawdbot) 應(yīng)用鏡像。
●?規(guī)格建議：?至少選擇?2核2G?配置，以保證多通道并發(fā)時(shí)的內(nèi)存充裕。
2. 安全組與端口放通（關(guān)鍵步驟）
注意：這是新手最容易踩坑的地方。
OpenClaw 默認(rèn)的 Web 控制臺(tái)管理端口為?18789。購(gòu)買(mǎi)實(shí)例后，必須進(jìn)入服務(wù)器的“防火墻/安全組”頁(yè)面：
●?點(diǎn)擊“添加規(guī)則”。
●?協(xié)議選擇?TCP，端口填入?18789。
●?授權(quán)對(duì)象填入?0.0.0.0/0（或您的本地專屬 IP），保存并生效。
3. 獲取管理憑證與初始化
1.??通過(guò)控制臺(tái)提供的 WebShell（或第三方 SSH 工具）登錄服務(wù)器。
2.??輸入應(yīng)用鏡像初始化命令（具體命令請(qǐng)參考服務(wù)器詳情頁(yè)的“應(yīng)用管理”提示），系統(tǒng)將自動(dòng)生成?Gateway Token?和初始訪問(wèn)地址。
3.??在瀏覽器中訪問(wèn) <您的服務(wù)器公網(wǎng)IP>:18789，填入 Token 即可進(jìn)入 Dashboard，完成 DeepSeek 等大模型的 API Key 綁定。
三、 手動(dòng)源碼部署（針對(duì)定制化開(kāi)發(fā)者）
如果您需要在本地 WSL2 或純凈版 Linux (如 Ubuntu 22.04 LTS) 上手動(dòng)部署，請(qǐng)嚴(yán)格按照以下系統(tǒng)依賴進(jìn)行配置。
1. 環(huán)境準(zhǔn)備：強(qiáng)制要求 Node.js v22
OpenClaw 對(duì) Node 版本有嚴(yán)格限制，低于 v22 可能導(dǎo)致編譯失敗。建議使用?nvm?管理：
# 下載并安裝 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bashsource~/.bashrc# 安裝并切換至 Node.js 22nvm install 22nvm use 22# 建議配置 npm 國(guó)內(nèi)鏡像加速依賴下載npm configsetregistry https://registry.npmmirror.com
2. 全局安裝與服務(wù)啟動(dòng)
# 全局安裝最新版 OpenClawnpm install -g openclaw@latest# 執(zhí)行初始化向?qū)Вㄅ渲媚Ｐ吞峁┥膛c接入通道）openclaw onboard# 啟動(dòng)核心網(wǎng)關(guān)服務(wù)openclaw gateway# 啟動(dòng)可視化 Dashboard 管理面板openclaw dashboard
四、 高頻報(bào)錯(cuò)排查與避坑指南 (Troubleshooting)
在社區(qū)答疑中，我們總結(jié)了以下高頻報(bào)錯(cuò)，建議在部署后對(duì)照檢查：
●?問(wèn)題 1：瀏覽器無(wú)法訪問(wèn) IP:18789?控制臺(tái)
○?排查思路：?90% 是因?yàn)樵品?wù)器防火墻未放行。請(qǐng)返回云廠商控制臺(tái)（如防火墻面板），確認(rèn) TCP?18789?端口處于開(kāi)啟狀態(tài)。若是手動(dòng)部署，請(qǐng)檢查 Linux 內(nèi)部防火墻（如?ufw allow 18789）。
●?問(wèn)題 2：npm install?階段卡死或報(bào)網(wǎng)絡(luò)超時(shí)（ETIMEDOUT）
○?排查思路：?境外 GitHub 或 npm 源被阻斷。請(qǐng)務(wù)必配置淘寶 npm 鏡像源，或在云服務(wù)商一鍵鏡像中直接跳過(guò)此步驟。
●?問(wèn)題 3：接入 DeepSeek 后回復(fù)異常或 Token 消耗過(guò)快
○?排查思路：?檢查 Dashboard 中的默認(rèn)系統(tǒng)提示詞（System Prompt）是否過(guò)長(zhǎng)。部署上線后，強(qiáng)烈建議第一時(shí)間修改默認(rèn)的 Gateway Token，防止接口被公網(wǎng)惡意掃描盜刷。
