OpenClaw（江湖昵稱“小龍蝦”）是一款開源的AI代理框架，支持本地私有化部署，用戶可在自有設(shè)備上運(yùn)行該框架，實現(xiàn)數(shù)據(jù)主權(quán)控制、零服務(wù)器成本使用及隱私安全保障。無論是個人測試、敏感數(shù)據(jù)處理還是開發(fā)調(diào)試，OpenClaw均能提供靈活的解決方案。本文將詳細(xì)介紹其本地安裝部署流程，涵蓋環(huán)境配置、安裝步驟及常見問題解決方案。
??提示：文章排版原因，資源教程鏈接地址放在圖片下面????，往下翻就行
??提示：文章排版原因，資源教程鏈接地址放在圖片下面????，往下翻就行
《快速部署OpenClaw(Clawdbot)極簡部署教程》資源(盡快保存，隨時失效)
https://pan.quark.cn/s/76138901bb76
提示（建議復(fù)制后瀏覽器搜索打開即可,手機(jī)用戶長按復(fù)制打開）保存后下載速度很快
資源完全免費，不會收取您任何費用，資源搜集于互聯(lián)網(wǎng)公開分享資源，如有侵權(quán)，聯(lián)系立刪。
一、部署前準(zhǔn)備
1. 系統(tǒng)與硬件要求
操作系統(tǒng)：支持Windows 10/11、macOS 12+、Linux（Ubuntu 20.04+/Debian 11+等主流發(fā)行版）。
硬件配置：
內(nèi)存：最低2GB，推薦4GB以上；若需本地運(yùn)行大模型，建議8GB+。
磁盤空間：預(yù)留至少500MB可用空間，推薦1GB以上。
CPU：多核2.0GHz+，支持x86-64架構(gòu)（ARM64需驗證兼容性）。
2. 軟件依賴
Node.js：必須安裝v22.x及以上版本（推薦v24 LTS），作為OpenClaw的運(yùn)行基礎(chǔ)。
Git：用于版本控制與代碼管理，Windows用戶需勾選“Add to PATH”選項。
Python：建議安裝Python 3.9+，部分技能插件依賴Python環(huán)境。
網(wǎng)絡(luò)環(huán)境：需穩(wěn)定聯(lián)網(wǎng)以下載依賴包；若需調(diào)用云端大模型，需保持網(wǎng)絡(luò)暢通。
3. 權(quán)限與路徑
管理員權(quán)限：Windows用戶需以管理員身份運(yùn)行PowerShell，避免權(quán)限不足導(dǎo)致安裝失敗。
安裝路徑：避免使用中文、空格或特殊符號（如“我的文檔”“Open Claw”），防止路徑解析錯誤。
二、安裝步驟
1. 安裝Node.js與Git
Node.js：從Node.js官網(wǎng)下載v22.x+安裝包，安裝時勾選“Add to PATH”。
Git：
Windows：下載Git for Windows，安裝時選擇默認(rèn)配置。
macOS：通過Homebrew安裝（brew install git）。
Linux：使用包管理器安裝（如Ubuntu的sudo apt install git）。
2. 配置npm鏡像（可選）
若網(wǎng)絡(luò)連接較慢，可配置npm鏡像加速依賴下載：
bash
1npm config set registry https://registry.npmmirror.com2
3. 安裝OpenClaw
一鍵安裝腳本（推薦）：
Windows：以管理員身份運(yùn)行PowerShell，執(zhí)行以下命令：
powershell
1iwr -useb https://openclaw.ai/install.ps1 | iex2
若下載失敗，可使用國內(nèi)鏡像：
powershell
1iwr -useb https://clawd.org.cn/install.ps1 | iex2
macOS/Linux：在終端執(zhí)行：
bash
1curl -fsSL https://openclaw.ai/install.sh | bash2
NPM全局安裝：若已安裝Node.js，可直接通過npm安裝：
bash
1npm install -g openclaw@latest2
4. 初始化配置
運(yùn)行初始化向?qū)擅荑€與配置文件：
bash
1openclaw onboard --install-daemon2
按提示操作：
設(shè)置Agent名稱：自定義AI代理的名稱。
配置大模型API Key：
國內(nèi)用戶推薦選擇阿里云百煉（DashScope）或通義千問（Qwen），新用戶可獲免費Token額度。
海外用戶可選擇OpenAI、Anthropic等模型，需自行準(zhǔn)備API Key。
若需本地模型，可跳過此步驟，后續(xù)通過配置文件接入Ollama等本地大模型。
設(shè)置工作目錄：默認(rèn)~/.openclaw/，可根據(jù)需求修改。
安裝系統(tǒng)服務(wù)：選擇是否將OpenClaw注冊為系統(tǒng)服務(wù)（如launchd或systemd）。
配置通信平臺：如需接入Telegram、飛書等，按提示填寫App ID與密鑰；暫不需要可跳過。
5. 啟動服務(wù)
啟動網(wǎng)關(guān)：
bash
1openclaw gateway start2
驗證狀態(tài)：
bash
1openclaw gateway status2
若顯示“Running”，則服務(wù)啟動成功。
6. 訪問控制臺
打開瀏覽器，輸入以下地址：
1http://localhost:187892
首次訪問需使用Token認(rèn)證，Token可在配置文件~/.openclaw/openclaw.json中查找，或通過命令生成帶Token的鏈接：
bash
1openclaw dashboard2
三、進(jìn)階配置
1. 接入本地大模型（如Ollama）
若需完全離線運(yùn)行，可配置OpenClaw使用本地大模型：
安裝Ollama：從Ollama官網(wǎng)下載并安裝。
拉取模型：
bash
1ollama pull qwen2.5? # 以Qwen2.5為例2
修改OpenClaw配置：在config/models.json中添加本地模型配置：
json
1{2? "ollama": {3? ? "base_url": "http://localhost:11434",4? ? "model": "qwen2.5",5? ? "temperature": 0.76? }7}8
重啟服務(wù)：
bash
1openclaw gateway restart2
2. 配置企業(yè)IM平臺（如飛書）
創(chuàng)建飛書應(yīng)用：在飛書開放平臺創(chuàng)建應(yīng)用，獲取App ID與App Secret。
配置權(quán)限：在飛書開放平臺配置應(yīng)用權(quán)限，包括消息收發(fā)、用戶信息讀取等。
修改OpenClaw配置：在config/channels.json中添加飛書配置：
json
1{2? "feishu": {3? ? "app_id": "your_app_id",4? ? "app_secret": "your_app_secret",5? ? "bot_token": "your_bot_token"6? }7}8
重啟服務(wù)：
bash
1openclaw gateway restart2
四、常見問題解決方案
1. 安裝失敗或速度慢
配置npm鏡像：
bash
1npm config set registry https://registry.npmmirror.com2
使用國內(nèi)安裝腳本：
powershell
1iwr -useb https://clawd.org.cn/install.ps1 | iex2
2. 權(quán)限問題
Windows：以管理員身份運(yùn)行PowerShell，避免權(quán)限不足。
Linux：修復(fù)全局包安裝權(quán)限：
bash
1sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}2
3. 服務(wù)啟動失敗
檢查端口占用：
bash
1netstat -tulnp | grep 187892
若端口被占用，修改OpenClaw配置中的端口號或終止占用進(jìn)程。
查看日志：
bash
1openclaw gateway logs2
根據(jù)日志信息排查問題。
4. 模型調(diào)用失敗
檢查API Key：確保大模型API Key有效且未過期。
驗證模型配置：確認(rèn)config/models.json中的模型名稱與接口地址正確。
測試本地模型：若使用本地模型，通過ollama list驗證模型是否已拉取成功。
五、總結(jié)
OpenClaw的本地部署流程涵蓋環(huán)境準(zhǔn)備、安裝、初始化配置、服務(wù)啟動及進(jìn)階功能配置。通過本文的詳細(xì)指南，用戶可快速完成部署，并根據(jù)需求接入本地或云端大模型、企業(yè)IM平臺等。若遇問題，可優(yōu)先檢查日志與配置文件，或參考官方文檔獲取更多支持。
