OpenClaw 的安裝被傳得 “門檻極高”，但只要剔除冗余步驟、按系統(tǒng)精準(zhǔn)操作，零基礎(chǔ)也能搞定。本次教程針對MacOS、Linux（Ubuntu 22.04）、Windows11 三大主流系統(tǒng)，全程本地原生部署（無需云端服務(wù)器），包含環(huán)境配置、依賴安裝、服務(wù)啟動全流程，新手友好。

本教程僅針對 OpenClaw 官方開源版，所有操作均在本地完成，無需付費服務(wù)器；全程重點：版本匹配（Python 3.10-3.12）、依賴裝全、配置文件正確初始化。

一、部署前置準(zhǔn)備（必做！缺一不可）

1. 通用軟件依賴（所有系統(tǒng)都要裝）

2. 系統(tǒng)專屬依賴（按自己系統(tǒng)裝）

MacOS：僅需安裝 Xcode 命令行工具（終端執(zhí)行 xcode-select --install，彈窗點 “安裝” 即可）；

Linux（Ubuntu 22.04）：基礎(chǔ)編譯 / 虛擬環(huán)境工具（后續(xù)步驟會給一鍵安裝命令）；

Windows11：必須先裝 WSL2+Ubuntu 22.04 子系統(tǒng)（原生 Windows 兼容性差，新手必走此路）。

3. 核心憑證（必須提前準(zhǔn)備）

注冊阿里云賬號并完成實名認(rèn)證，開通「阿里云百煉大模型服務(wù)」，獲取 API Key（需訂閱阿里云百煉 Coding Plan）—— 這是 OpenClaw 調(diào)用大模型的核心憑證，后續(xù)要填到配置文件里。

二、分系統(tǒng)詳細部署步驟（新手建議一步步復(fù)制命令）

1. MacOS 系統(tǒng)本地部署

bash

運行

# 步驟1：克隆OpenClaw官方倉庫（下載代碼）

git clone https://github.com/openclaw-project/openclaw.git

cd openclaw  # 進入代碼目錄（后續(xù)所有操作都在這個目錄下）

# 步驟2：創(chuàng)建Python虛擬環(huán)境（避免污染系統(tǒng)Python）

python3 -m venv claw-env  # 創(chuàng)建名為claw-env的虛擬環(huán)境

source claw-env/bin/activate  # 激活虛擬環(huán)境（終端前綴會出現(xiàn)(claw-env)，代表激活成功）

# 步驟3：升級pip并安裝依賴（--no-cache-dir解決緩存導(dǎo)致的安裝失敗）

pip install --upgrade pip

pip install -r requirements.txt --no-cache-dir

# 步驟4：初始化配置文件（復(fù)制示例配置為正式配置）

cp config/example_config.json config/claw_config.json

# 【關(guān)鍵】此時需要編輯claw_config.json，填入阿里云百煉的API Key（新手可用文本編輯器打開改）

# 步驟5：啟動服務(wù)（新手先前臺運行，方便看日志）

python -m openclaw.gateway

# （進階）后臺運行（不占用終端，關(guān)閉終端也能運行）

# nohup python -m openclaw.gateway > claw_run.log 2>&1 &

# tail -f claw_run.log  # 查看后臺運行日志（有報錯能及時發(fā)現(xiàn)）

 啟動成功標(biāo)志：終端無報錯，顯示 “OpenClaw Gateway started on port xxx”（端口號通常是 8000）。

2. Linux 系統(tǒng)（Ubuntu 22.04）本地部署

bash

運行

# 步驟1：更新系統(tǒng)源+安裝基礎(chǔ)依賴（一鍵執(zhí)行，輸入密碼即可）

sudo apt update && sudo apt upgrade -y

sudo apt install -y git python3 python3-venv python3-pip gcc g++ libssl-dev

# 步驟2：克隆倉庫并進入目錄

git clone https://github.com/openclaw-project/openclaw.git

cd openclaw

# 步驟3：配置虛擬環(huán)境并激活

python3 -m venv claw-env

source claw-env/bin/activate

# 步驟4：安裝依賴+初始化配置文件

pip install --upgrade pip

pip install -r requirements.txt

cp config/example_config.json config/claw_config.json

# 【關(guān)鍵】編輯claw_config.json，填入阿里云百煉API Key

# 步驟5：配置系統(tǒng)服務(wù)（實現(xiàn)開機自啟，不用每次手動啟動）

sudo tee /etc/systemd/system/openclaw.service << EOF

[Unit]

Description=OpenClaw AI Agent Local Service

After=network.target

[Service]

User=$USER

WorkingDirectory=$(pwd)

ExecStart=$(pwd)/claw-env/bin/python -m openclaw.gateway

Restart=on-failure

RestartSec=5

[Install]

WantedBy=multi-user.target

EOF

# 步驟6：啟動服務(wù)并設(shè)置開機自啟

sudo systemctl daemon-reload  # 重新加載系統(tǒng)服務(wù)配置

sudo systemctl start openclaw  # 啟動OpenClaw服務(wù)

sudo systemctl enable openclaw  # 設(shè)置開機自啟

# 步驟7：驗證部署是否成功（出現(xiàn)active(running)即為成功）

sudo systemctl status openclaw

常見報錯：如果提示 “權(quán)限不足”，確認(rèn)命令前加了sudo；如果提示 “Python 版本不對”，卸載多余 Python 版本，僅保留 3.10-3.12。

3. Windows11 系統(tǒng)本地部署（WSL2+Ubuntu 22.04，推薦）

Windows 原生環(huán)境不兼容，必須先裝 WSL2，步驟如下：

第一步：安裝 WSL2+Ubuntu 22.04（管理員模式打開 PowerShell）

powershell

# 啟用WSL2功能

wsl --install -d Ubuntu-22.04

# 安裝完成后重啟電腦，按提示設(shè)置Ubuntu的用戶名和密碼（記住！后續(xù)要用）

第二步：進入 Ubuntu 子系統(tǒng)部署（和 Linux 步驟幾乎一致）

bash

運行

# 1. 打開PowerShell，進入Ubuntu 22.04子系統(tǒng)

wsl.exe -d Ubuntu-22.04

# 2. 后續(xù)命令完全復(fù)用Linux部署步驟（復(fù)制粘貼即可）

sudo apt update && sudo apt upgrade -y

sudo apt install -y git python3 python3-venv python3-pip gcc g++ libssl-dev

git clone https://github.com/openclaw-project/openclaw.git

cd openclaw

python3 -m venv claw-env

source claw-env/bin/activate

pip install --upgrade pip

pip install -r requirements.txt

cp config/example_config.json config/claw_config.json

# 3. 編輯配置文件填入API Key，啟動服務(wù)

python -m openclaw.gateway

 驗證成功：Ubuntu 終端顯示 “OpenClaw Gateway started”，代表部署完成。

三、新手必看避坑指南

Python 版本問題：如果終端輸入python3 --version顯示不是 3.10-3.12，先卸載舊版本，或用pyenv管理多版本；

虛擬環(huán)境激活失敗：Mac/Linux 下如果source命令報錯，換./claw-env/bin/activate；

依賴安裝失�。篗acOS 確保裝了 Xcode 命令行工具，Linux 確保gcc/g++安裝成功，Windows 確保 WSL2 網(wǎng)絡(luò)正常；

API Key 配置錯誤：阿里云百煉的 API Key 要填對，否則啟動后調(diào)用大模型會提示 “認(rèn)證失敗”。

總結(jié)

零基礎(chǔ)部署核心：先裝對依賴（Python 3.10-3.12 + 系統(tǒng)專屬工具），再克隆代碼，用虛擬環(huán)境裝依賴，填對 API Key，最后啟動服務(wù)；

Windows 用戶必須走 WSL2+Ubuntu 路線，避免原生環(huán)境兼容性問題；

啟動成功的核心標(biāo)志：終端無報錯，顯示 “OpenClaw Gateway started”，且能正常調(diào)用大模型（測試指令可執(zhí)行簡單的 “打開記事本” 等操作）。

如果部署中遇到具體報錯，優(yōu)先看終端日志（前臺運行直接看，后臺運行看claw_run.log），90% 的問題都是版本不匹配、依賴沒裝全、API Key 填錯這三類。

BestClaw 是由天下數(shù)據(jù)打造的 OpenClaw 專屬云主機解決方案，集服務(wù)器 + API + 部署 + 售后于一體。

詳情：http://m.51huadong.com/2026/bestclaw.asp

本文鏈接：http://m.51huadong.com/cloundnews/11016962.html