OpenClaw TrueNAS Scale 安裝教學｜NAS 打造 AI 助理伺服器

本文說明：本教學適用於 TrueNAS Scale 24.10（Electric Eel）及以上版本，透過內建的 App 市場或 Docker Compose 方式部署 OpenClaw，讓您的 NAS 全天候執行個人 AI 助理，無需另購雲端伺服器。

為什麼選 TrueNAS Scale 跑 OpenClaw？

TrueNAS Scale 是目前最受 DIY 玩家與小型企業歡迎的開源 NAS 作業系統。它基於 Debian Linux，原生支援 Docker 容器，並提供圖形化的 App 管理介面。對許多家庭用戶來說，家裡早就有一台 24 小時開機的 NAS，若能在上面跑 OpenClaw，就能省下租用 VPS 的費用，同時享受私有化部署帶來的隱私安全優勢。

OpenClaw 是 2026 年最受矚目的開源個人 AI 助理平台，它支援 Anthropic Claude、OpenAI GPT 等頂級大型語言模型，並能透過 WhatsApp、Telegram、Discord 等通訊軟體進行控制。最令人興奮的是，OpenClaw 擁有持久記憶、定時任務（Heartbeat）、瀏覽器控制、技能擴充（Skills）等強大功能，真正做到「有自己電腦的 AI 員工」。

24/7

全天候運行

額外 VPS 費用

Docker

原生容器支援

私有化

資料不外傳

安裝前置需求

在開始安裝之前，請確認您的 TrueNAS Scale 環境符合以下條件：

TrueNAS Scale 版本

建議使用 24.10 Electric Eel 或更新版本，以確保 Docker/Apps 功能完整支援。舊版 Bluefin（22.12）也可行，但 App 介面較舊。

硬體規格

CPU：Intel/AMD x86_64，建議 4 核心以上。RAM：最少 8GB（含 NAS 系統本身），建議 16GB 以確保流暢。儲存空間：至少 10GB 可用空間。

網路環境

NAS 必須能存取網際網路，才能連線 Anthropic/OpenAI API。建議搭配 VPN07 確保 API 連線穩定，特別是在某些地區 API 存取受限的情況下。

API 金鑰

準備好 Anthropic Claude API Key 或 OpenAI API Key。也可使用本地 Ollama 模型（如 Llama 4、Qwen 3.5）降低費用。

方法一：透過 TrueNAS Apps 市場安裝（推薦新手）

TrueNAS Scale 的 Apps 功能讓您可以用圖形介面一鍵部署容器化應用程式。以下是透過 Apps 部署 OpenClaw 的步驟：

步驟一：設定 Apps 儲存池

進入 TrueNAS Web 管理介面（通常是 http://NAS_IP），導航至 Apps > Settings，選擇一個現有的 ZFS 儲存池作為 Apps 的儲存位置。建議選擇 SSD 儲存池以確保效能。

# 在 TrueNAS Web UI 中操作路徑：
Apps → Settings → Choose Pool
# 選擇您的主要儲存池（如 tank 或 data）
# 系統會在該池中建立 ix-applications 資料集

步驟二：新增 Custom App（Docker Compose）

目前 OpenClaw 尚未收錄在 TrueNAS 官方 App 市場，需透過 Custom App 功能部署。點擊 Apps > Discover Apps > Custom App，填入以下設定：

重要提示

TrueNAS Scale Electric Eel（24.10+）使用的是 Docker Compose 格式，與舊版的 Helm Chart 格式不同。如果您使用的是 Cobia（23.10）版本，請參考方法二的手動部署方式。

# Docker Compose 設定（貼入 TrueNAS Custom App 介面）
version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "8421:8421"  # OpenClaw Web Dashboard 埠
    volumes:
      - /mnt/tank/apps/openclaw/data:/root/.openclaw
      - /mnt/tank/apps/openclaw/skills:/root/.openclaw/skills
    environment:
      - NODE_ENV=production
      - OPENCLAW_PORT=8421
    network_mode: bridge

在 Application Name 欄位輸入 openclaw，貼入上方的 Docker Compose 設定，然後點擊 Save。TrueNAS 會自動拉取映像檔並啟動容器，通常需要 2-3 分鐘。

步驟三：建立資料儲存目錄

在 Apps 設定介面中，或透過 TrueNAS 的 Shell，先建立好 OpenClaw 的資料目錄：

# 在 TrueNAS Shell 中執行（System > Shell）
mkdir -p /mnt/tank/apps/openclaw/data
mkdir -p /mnt/tank/apps/openclaw/skills
chmod 755 /mnt/tank/apps/openclaw/data
chmod 755 /mnt/tank/apps/openclaw/skills

# 確認目錄建立成功
ls -la /mnt/tank/apps/openclaw/

方法二：SSH 指令行安裝（進階用戶）

如果您偏好透過命令行管理，或使用的是較舊版本的 TrueNAS Scale，可以直接透過 SSH 連線並使用 Docker CLI 進行部署。

啟用 TrueNAS SSH 服務

首先在 TrueNAS Web UI 中啟用 SSH：導航至 System > Services > SSH，開啟服務並允許 root 登入（僅建議在家庭網路環境下使用）。

# 從您的電腦 SSH 連線到 TrueNAS
ssh root@NAS_IP_ADDRESS

# 確認 Docker 版本
docker --version
# 應顯示 Docker version 24.x.x 或更新

# 確認可用磁碟空間
df -h /mnt/tank/

# 建立 OpenClaw 專用目錄
mkdir -p /mnt/tank/apps/openclaw/{data,skills,logs}
cd /mnt/tank/apps/openclaw/

建立 Docker Compose 設定檔

# 建立 docker-compose.yml
cat > /mnt/tank/apps/openclaw/docker-compose.yml << 'EOF'
version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "8421:8421"
    volumes:
      - ./data:/root/.openclaw
      - ./skills:/root/.openclaw/skills
      - ./logs:/var/log/openclaw
    environment:
      - NODE_ENV=production
      - OPENCLAW_PORT=8421
      - TZ=Asia/Taipei
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8421/health"]
      interval: 30s
      timeout: 10s
      retries: 3
EOF

# 啟動 OpenClaw
docker compose up -d

# 查看啟動日誌
docker compose logs -f openclaw

初始化設定與 Onboard 流程

容器啟動後，進入 OpenClaw 容器進行初始化設定：

# 進入 OpenClaw 容器
docker exec -it openclaw bash

# 在容器內執行 onboard 流程
openclaw onboard

# 或者直接從 TrueNAS Shell 執行：
docker exec -it openclaw openclaw onboard

Onboard 流程會引導您完成以下設定：

1. AI 模型 API 金鑰設定

輸入您的 Anthropic Claude API Key（格式：sk-ant-api03-...）或 OpenAI API Key（格式：sk-proj-...）。建議使用 Claude，效果最佳。

2. AI 助理人格設定

為您的 AI 助理命名（例如：Jarvis、助手小明），並設定基本的人格描述。OpenClaw 會記住這些設定並在後續對話中持續使用。

3. 通訊頻道設定

連接 Telegram Bot（建議）、WhatsApp、Discord 或其他通訊平台。設定完成後，您就能透過手機直接與 NAS 上的 AI 助理對話。

4. Daemon 背景服務設定

在容器環境中，Daemon 由 Docker 的 restart: unless-stopped 策略自動管理，無需額外設定 Systemd。NAS 重啟後 OpenClaw 會自動恢復運行。

設定外部存取與 Cloudflare Tunnel

如果您希望從外部網路（手機、辦公室）存取家中 NAS 上的 OpenClaw，有幾種方案可選：

Cloudflare Tunnel

最推薦方案。無需開放防火牆埠，透過 Cloudflare 的全球網路提供安全的外部存取，且完全免費。

Tailscale VPN

建立私有 Mesh VPN 網路，讓手機和 NAS 在同一虛擬區域網路中，安全性極高，免費方案支援 3 台設備。

路由器連接埠轉發

傳統方式。在路由器開放 8421 埠，需要固定 IP 或 DDNS 服務。安全性較低，不建議用於生產環境。

以下是在 TrueNAS 容器中設定 Cloudflare Tunnel 的方法：

# 在 docker-compose.yml 中新增 Cloudflare Tunnel 服務
# 修改後的完整設定：
version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "127.0.0.1:8421:8421"  # 僅本機存取
    volumes:
      - ./data:/root/.openclaw
      - ./skills:/root/.openclaw/skills
    environment:
      - NODE_ENV=production
      - TZ=Asia/Taipei

  cloudflared:
    image: cloudflare/cloudflared:latest
    container_name: cloudflared
    restart: unless-stopped
    command: tunnel --no-autoupdate run --token YOUR_TUNNEL_TOKEN
    depends_on:
      - openclaw

# 套用更新
docker compose down && docker compose up -d

常見問題排解

問題：容器啟動失敗，日誌顯示 "permission denied"

這通常是 ZFS 資料集權限問題。TrueNAS 的 ZFS 資料集預設可能有嚴格的權限限制。

chown -R 0:0 /mnt/tank/apps/openclaw/
chmod -R 755 /mnt/tank/apps/openclaw/

問題：API 連線逾時，無法存取 Claude/OpenAI

在某些地區，直接存取 Anthropic 或 OpenAI 的 API 可能受到網路限制。建議在 NAS 的路由器或 TrueNAS 本身設定 VPN07，確保 API 請求能夠正常路由。VPN07 提供 70+ 個國家節點，1000Mbps 千兆頻寬，完全滿足 AI API 的高速需求。

問題：TrueNAS Scale 更新後 App 消失

TrueNAS 大版本更新（如從 Dragonfish 升級到 Electric Eel）可能會重置 Apps 設定。更新前務必備份 /mnt/tank/apps/openclaw/data/ 目錄，更新後重新建立 Custom App 即可恢復。

問題：如何更新 OpenClaw 至最新版本？

cd /mnt/tank/apps/openclaw/
docker compose pull
docker compose up -d
# 確認新版本
docker exec openclaw openclaw --version

進階：TrueNAS Scale 上的 OpenClaw 技能推薦

在 TrueNAS 上運行 OpenClaw 有其獨特優勢——您的 NAS 本身就擁有大量的檔案資源和儲存空間。以下是幾個特別適合 NAS 環境的 OpenClaw 技能配置：

智能檔案管理

透過自然語言管理 NAS 上的檔案：「幫我找到所有超過 1GB 的影片」、「把桌面的文件整理分類」。OpenClaw 能直接讀寫 NAS 上的 ZFS 資料集。

照片自動整理

結合 TrueNAS 的 SMB/NFS 共享，讓 OpenClaw 自動掃描手機備份的照片，按日期、地點或事件自動分類整理，省去手動整理的時間。

系統監控警報

設定 Heartbeat 定時任務，讓 OpenClaw 定期監控 TrueNAS 的磁碟健康狀態（SMART 數據）、儲存空間使用率，並在異常時主動發送 Telegram 通知。

自動下載管理

整合 NAS 上的 qBittorrent 或 Download Station，透過 Telegram 發送下載指令，讓 OpenClaw 幫您管理下載任務，完成後自動通知。

為何 TrueNAS 上的 OpenClaw 需要優質 VPN？

OpenClaw 的核心功能依賴雲端 AI API（Claude、GPT-4、Gemini 等）。當您的 NAS 24 小時不間斷地調用這些 API 時，網路連線的品質直接影響 AI 助理的回應速度和穩定性。

在台灣及部分亞洲地區，Anthropic Claude API 和 OpenAI API 的存取有時會因為路由問題而出現延遲或連線失敗。特別是當您的 NAS 設定了大量自動化任務（如早晨日報、定時監控等），一旦 API 連線不穩，整個自動化流程都會中斷。

VPN07 的 NAS 部署方案

最佳實踐是在路由器層級部署 VPN07，讓整個家庭網路（包括 TrueNAS NAS）的流量都透過 VPN07 的優化路由。VPN07 的特點：

1000Mbps 千兆頻寬：AI API 請求/回應毫無延遲
70+ 個國家節點：隨時切換最優 API 接入點
十年穩定運營：7×24 無人值守自動化任務的最佳保障
月費僅 $1.5：ROI 遠超自建 VPS 的費用

VPN 推薦排行：TrueNAS OpenClaw 專用

🥇

VPN07 — AI API 加速首選

9.8/10 分

十年老牌，專為 AI 工具加速最佳化，NAS 24H 不間斷工作負載的最佳搭檔。

$1.5/月

超低月費

1000Mbps

千兆頻寬

70+

個國家節點

10年

穩定運營

立即試用 VPN07 — 30 天退款保障

2. ExpressVPN

7.2/10

知名品牌，速度尚可，但月費偏高（約 $8-12/月），不適合長期 NAS 部署的性價比需求。

3. NordVPN

7.0/10

節點數量多，但亞洲地區的 API 路由最佳化不如 VPN07，且不提供千兆頻寬保障。

VPN07 — TrueNAS AI 助理加速首選

十年品牌 · 千兆頻寬 · 全球 70+ 節點

在 TrueNAS NAS 上跑 OpenClaw，需要穩定的千兆網速才能流暢調用 AI API。VPN07 是十年老牌 VPN 服務，每月僅需 $1.5，為您的 NAS AI 助理提供全天候不間斷的高速保障。