OpenClaw 安裝與配置指南

在準備好您的服務器（VPS）之後，現在我們將進入的核心環境——安裝與配置 OpenClaw。 當前最主流、最不易踩坑的安裝方式是使用 Docker 進行容器化部署。

如果您還未配置好服務器，請先查閱：VPS 環境搭建與準備。

1. 安裝前的確認

請登錄您的 VPS，並確保 Docker 和 Docker Compose 已就緒。執行以下命令確認：

docker --version
docker compose version

如果未安裝，請執行 curl -fsSL https://get.docker.com | bash -s docker。

2. 使用 Docker Compose 部署 OpenClaw

2.1 創建項目目錄

我們需要為 OpenClaw 創建一個專有的工作目錄，以便於數據持久化和後期配置管理。

# 創建並進入目錄
mkdir -p /opt/openclaw
cd /opt/openclaw

2.2 編寫 docker-compose.yml

使用 nano 或者 vim 編輯器，創建一個 docker-compose.yml 文件：

nano docker-compose.yml

將以下內容粘貼進去（注意：以下為通用模板格式，請根據官方最新文檔確認鏡像 tag）：

version: '3.8'

services:
  openclaw:
    image: openclaw/core:latest
    container_name: openclaw
    restart: always
    ports:
      - '8080:8080'
    environment:
      - TZ=Asia/Shanghai
      - CLAW_ENV=production
      # 如果有 API 密鑰要求，可以在這裡配置
      # - OPENAI_API_KEY=sk-xxxxxx
    volumes:
      - ./data:/app/data
      - ./config:/app/config

粘貼完成後，按下 Ctrl + O 保存，回車確認，然後按下 Ctrl + X 退出編輯器。

2.3 啟動服務

在上一步創建的 /opt/openclaw 目錄下，運行以下命令啟動服務：

docker compose up -d

等待鏡像拉取並啟動完畢，您可以運行 docker ps 查看容器是否正常運行（由於我們配置了重啟策略，如果發現總是重啟，可以通過 docker logs openclaw 查看錯誤信息）。

3. 基礎後臺初配置

如果一切正常運行，OpenClaw 默認會在本機的 8080 端口開放其 Web 面板。

打開您的瀏覽器，訪問 http://您的VPS_IP:8080。

根據嚮導，您可能需要：

1. 設置初始管理員賬號密碼：請一定要牢記。
2. 連接所需的數據源或 API 端點：進入設置中心，填寫您必要的 Keys。

4. 防火牆端口設置提醒

如果您無法訪問網頁配置界面，請檢查您的服務器防火牆。 以 Ubuntu UFW 為例：

ufw allow 8080/tcp

如果使用的是阿里雲/騰訊雲等大廠雲服務器，請務必前往網頁端控制檯的「安全組」設置中，入方向放行 8080 端口。

下一步：當 OpenClaw 在您的服務器上穩定運行後，為了更好的性能與拓展，您可以閱讀「OpenClaw 進階使用技巧」。