這是一份全網(wǎng)最全的OpenClaw安裝部署教程，覆蓋Windows、macOS、Linux三系統(tǒng)本地部署，并最終提供Docker一鍵部署方案。所有命令均可直接復制執(zhí)行，包含完整的docker-compose.yml文件和安全操作命令。

一、部署方案對比：先選你的路

如果你是新手或希望長期穩(wěn)定使用，直接跳至第六章「終極方案：Docker一鍵部署」。

二、準備篇

2.1 Node.js（必需）

OpenClaw運行環(huán)境，必須 ≥ v22.x。

node -v   # 檢查版本

2.2 API Key（必需）

OpenClaw需要“大腦”——大模型API。推薦國內(nèi)用戶使用阿里云百煉（免費額度充足）或MiniMax。

• 阿里云百煉獲取：登錄阿里云百煉控制臺 → 密鑰管理 → 創(chuàng)建API-Key，保存 Access Key ID 和 Access Key Secret。
• 備用方案：OpenAI、Anthropic Claude等需海外網(wǎng)絡。

2.3 終端工具

• Windows：以管理員身份運行 PowerShell（右鍵點擊選擇）
• macOS/Linux：終端（Terminal）

三、Windows 11本地部署

3.1 解鎖PowerShell執(zhí)行權(quán)限

Set-ExecutionPolicy Bypass -Scope Process -Force

輸入 Y 確認。

3.2 一鍵安裝OpenClaw

# 官方穩(wěn)定版腳本
iwr -useb https://openclaw.ai/install.ps1 | iex

如果慢或用國內(nèi)鏡像：

iwr -useb https://clawd.org.cn/install.ps1 | iex

等待5-10分鐘，自動安裝Node.js及依賴。

3.3 驗證安裝

openclaw --version
# 應輸出如 2026.3.2-beta.1

3.4 配置并啟動服務

openclaw config set gateway.mode local   # 設為本地模式
openclaw gateway install                  # 安裝為Windows計劃任務（開機自啟）
openclaw gateway start                     # 啟動服務
openclaw gateway status                     # 檢查狀態(tài)，應為Running

3.5 訪問Web控制臺

瀏覽器打開：http://127.0.0.1:18789。

3.6 Windows常見問題

四、MacOS本地部署

4.1 安裝Homebrew（如無）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

4.2 安裝Node.js

brew install node@24
node -v   # 確保 ≥ v22

4.3 一鍵安裝OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash -s -- -Tag beta

或用國內(nèi)鏡像：

curl -fsSL https://clawd.org.cn/install.sh | bash

4.4 配置并啟動

openclaw config set gateway.mode local
openclaw gateway start
# 可選安裝為服務（開機自啟）
sudo openclaw gateway install

4.5 訪問

瀏覽器打開 http://localhost:18789。

4.6 macOS常見問題

五、Linux本地部署（Ubuntu 20.04+ 示例）

5.1 安裝Node.js

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -
sudo apt install -y nodejs
node -v   # 驗證

5.2 安裝OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash -s -- -Tag beta

5.3 配置并啟動

openclaw config set gateway.mode local
openclaw gateway start
# 安裝為服務
sudo openclaw gateway install

5.4 訪問

瀏覽器打開 http://localhost:18789。

5.5 Linux常見問題

六、終極方案：Docker一鍵部署（跨平臺，強烈推薦）

Docker方案環(huán)境隔離、統(tǒng)一體驗、安全可控，適合服務器或個人長期運行。

6.1 前提：安裝Docker和Docker Compose

• Docker Desktop：官網(wǎng)下載（Windows/macOS）
• Linux：

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER   # 退出重登錄生效

6.2 完整 docker-compose.yml 文件

創(chuàng)建項目目錄：

mkdir ~/openclaw-docker && cd ~/openclaw-docker

新建 docker-compose.yml，粘貼以下內(nèi)容：

version: '3.8'
services:
openclaw-gateway:
    # 使用官方預構(gòu)建鏡像（推薦，避免本地編譯）
    image:ghcr.io/openclaw/openclaw:latest
    container_name:openclaw
    restart:unless-stopped
    # 安全綁定：僅監(jiān)聽127.0.0.1，防止公網(wǎng)直接暴露
    ports:
      -"127.0.0.1:18789:18789"
    volumes:
      # 持久化配置、會話、記憶數(shù)據(jù)
      -./data:/home/node/.openclaw
      # 如需讓AI操作宿主機文件，可掛載額外目錄（可選）
      # - /宿主機路徑:/容器內(nèi)路徑:ro
    environment:
      -TZ=Asia/Shanghai
      -NODE_ENV=production
      # 如需配置代理（使用宿主機代理）
      # - http_proxy=http://host.docker.internal:7890
      # - https_proxy=http://host.docker.internal:7890
    # 安全加固：降低容器權(quán)限
    cap_drop:
      -NET_RAW
      -NET_ADMIN
    security_opt:
      -no-new-privileges:true

6.3 完整安全命令（部署+啟動）

# 1. 創(chuàng)建數(shù)據(jù)持久化目錄
mkdir -p ./data
# 2. 啟動容器（后臺運行）
docker compose up -d
# 3. 查看實時日志，確認啟動成功
docker compose logs -f
# 看到類似 "[gateway] listening on ws://0.0.0.0:18789" 即成功
# 4. 進入容器執(zhí)行初始化配置向?qū)?
docker exec -it openclaw bash

6.4 容器內(nèi)初始化（首次必需）

進入容器后，執(zhí)行：

# 運行onboard向?qū)?
openclaw onboard

向?qū)来卧儐枺?/p>

• 工作區(qū)路徑：直接回車（默認）
• AI模型提供商：選 aliyun-bailian（阿里云）或 minimax 等
• 輸入API Key：粘貼你獲取的Key（阿里云需填 AccessKey ID 和 Secret）
• 網(wǎng)關(guān)端口：直接回車（18789）
• 聊天平臺接入：先選 Skip（后續(xù)可配）
• 安裝守護進程：選 N（容器內(nèi)不需要）

完成后輸入 exit 退出容器。

6.5 獲取訪問令牌并登錄

# 查看生成的網(wǎng)關(guān)令牌
grep -A1 '"token"' ./data/openclaw.json

輸出類似：

"token": "你的令牌字符串"

瀏覽器訪問：http://127.0.0.1:18789/?token=你的令牌字符串。

安全提示：令牌是訪問控制UI的憑證，切勿泄露。

6.6 Docker常用管理命令

6.7 安全加固建議（生產(chǎn)環(huán)境必看）

• 端口暴露：配置中已綁定 127.0.0.1，宿主機外無法直接訪問。如需公網(wǎng)訪問，必須使用反向代理+HTTPS+令牌認證。
• 數(shù)據(jù)持久化：./data目錄包含API Key等敏感信息，務必定期備份，勿提交到Git。
• 更新鏡像：定期執(zhí)行 docker compose pull && docker compose up -d 獲取安全更新。
• 防火墻：如非必要，公網(wǎng)防火墻關(guān)閉18789端口。

七、初始化配置向?qū)В╫nboard）詳解

無論哪種安裝方式，首次運行都必須執(zhí)行 openclaw onboard。以下是關(guān)鍵步驟：

• 安全確認：閱讀并同意安全最佳實踐。
• 選擇模型提供商：根據(jù)你獲取的API Key選擇（阿里云百煉、MiniMax、OpenAI等）。
• 輸入API憑據(jù)：
• 阿里云百煉：需 AccessKey ID 和 AccessKey Secret
• 其他：通常只需 API Key
• 配置渠道：可選擇接入飛書、Telegram等（初次可跳過）。
• Skills配置：推薦安裝默認技能包（瀏覽器控制、定時任務等）。
• 完成：向?qū)ё詣由膳渲梦募臃铡?/li>

驗證配置成功：

openclaw doctor    # 全面健康檢查
openclaw status    # 查看網(wǎng)關(guān)狀態(tài)
openclaw dashboard # 打開Web控制臺（需已啟動）

八、常見問題速查表

九、總結(jié)性的兩句

從零到一，你已成功在本地或Docker中運行起OpenClaw。它不再是只會說話的聊天機器人，而是一個真正能幫你干活、24小時在線的數(shù)字員工。

• 文件整理：一句話歸檔桌面文件
• 信息速讀：丟給它論文或鏈接，自動總結(jié)摘要
• 定時任務：每天早報、郵件提醒自動推送
• 未來擴展：接入飛書/釘釘、安裝社區(qū)Skills，讓它學會更多技能

接下來可以做什么？

• 瀏覽官方Skill市場：openclaw skills list
• 學習飛書接入教程（后續(xù)文章）
• 關(guān)注版本更新：openclaw --version，定期升級

到此這篇關(guān)于Windows、macOS、Linux三系統(tǒng)本地部署OpenClaw+避坑指南+Docker一鍵部署,30分鐘搞定的文章就介紹到這了,更多相關(guān)OpenClaw安裝部署教程內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論