NAS 部署指南
OpenClaw 在 NAS 上部署完整教程 — 绿联 / 群晖 / 威联通通用
家里有 NAS,就有了 7×24 小时不关机的服务器。本文详解如何在绿联 UGOS、群晖 DSM、威联通 QTS 上部署 OpenClaw AI 智能体,包括 Docker Compose 模板、代理配置、端口映射和数据持久化。
为什么在 NAS 上跑 OpenClaw?
- 7×24 在线 — NAS 本来就是常开设备,AI 助手随时可用
- 数据本地 — 所有对话、记忆、文件都在自己 NAS 上,不上云
- 免月租 — 一次性硬件投入,省掉云服务器月费
- 性能够用 — 4G 内存的入门 NAS 跑 OpenClaw 调用云端模型完全没压力
硬件要求
- 支持 Docker 的 NAS(绿联 DXP 系列、群晖 Plus 系列、威联通 TS-x53 起步)
- 至少 2GB 内存(推荐 4GB+)
- 5GB 以上空闲存储空间
- 能访问外网(调用云端模型 API 必需)
方案 A:绿联 UGOS Pro
绿联 NAS 自带 Docker,支持 Compose。通过 UGOS 应用中心 → 容器管理:
- 打开「容器管理」→「项目」→「新建」
- 项目名称:
openclaw - 选择「使用 docker-compose.yml 创建」
- 粘贴下面的 Compose 模板,保存并启动
- 启动后访问
http://NAS_IP:3210进入 Gateway
方案 B:群晖 DSM 7
群晖 DSM 7 用「Container Manager」(旧版叫 Docker):
- 套件中心安装「Container Manager」
- 左侧「项目」→「新增」
- 设置项目路径:
/docker/openclaw - 来源选「创建 docker-compose.yml」,粘贴下面模板
- 下一步、下一步、完成
方案 C:威联通 QTS
威联通通过 Container Station:
- App Center 安装 Container Station
- 「应用程序」→「建立」→「使用 YAML」
- 粘贴 Compose 模板,启动
通用 Docker Compose 模板
version: '3.8'
services:
openclaw:
image: ghcr.io/openclaw/openclaw:2026.4.14
container_name: openclaw
restart: unless-stopped
ports:
- "3210:3210"
volumes:
- ./data:/home/node/.openclaw
environment:
- TZ=Asia/Shanghai
# 如需走代理,取消下面注释(IP 改成你软路由的地址)
# - HTTP_PROXY=http://192.168.1.1:7890
# - HTTPS_PROXY=http://192.168.1.1:7890
# - NO_PROXY=localhost,127.0.0.1,192.168.0.0/16,10.0.0.0/8
networks:
- openclaw-net
networks:
openclaw-net:
driver: bridgeNAS 代理配置(绿联 / 群晖通用)
「绿联 openclaw 代理」是国内 NAS 用户最常搜的关键词。NAS 通常没有自带翻墙能力,需要配代理才能访问 Claude / GPT / Gemini 等海外模型 API。三种常用方案:
- 软路由全局代理(推荐) — 在软路由上跑 Clash / OpenClash,NAS 流量透明走代理,OpenClaw 容器无感知
- NAS 上跑 Clash 容器 — 在同一台 NAS 上跑
dreamacro/clash,OpenClaw 通过HTTP_PROXY指向 Clash 容器 IP - 境外模型走 OpenRouter — 国内可直连 openrouter.ai 的部分节点,配 OpenRouter 一个 Key 就能用 Claude/GPT/Gemini,省掉代理问题
详细代理配置见 OpenClaw 代理设置教程。
验证部署
- 容器启动后,浏览器访问
http://NAS_IP:3210 - 第一次访问会出现 device pairing 页面,复制设备码
- 用同局域网手机扫码或网页登录,完成配对
- 进入设置 → Models,配一个 provider(推荐先用 DeepSeek,国内可直连)
- 在「Chat」里发一条消息测试,能正常回复说明部署成功
外网访问(可选)
想在外网用手机连家里 NAS 的 OpenClaw,三种方案:
- 群晖 QuickConnect / 绿联远程访问 — 厂商内网穿透,最简单
- Tailscale — 零配置 VPN,免费 100 设备
- Cloudflare Tunnel — 给 NAS 套个公网域名,HTTPS 自动配好
如果你不想折腾外网穿透,最简单的办法就是用 OpenClaw Launch 托管版 — $3/月起,公网域名 + HTTPS + 代理 + 模型全包,省下 NAS 折腾时间。
常见问题
NAS 内存不够会怎样?
OpenClaw 主进程占用 ~300MB,每个 MCP Server 50-200MB。2GB 内存的 NAS 跑 OpenClaw + 一两个 MCP 没问题,4GB+ 推荐。
为什么我用 ARM 芯片的 NAS 跑不起来?
OpenClaw 镜像支持 amd64 和 arm64。如果是 32 位 ARM 老 NAS(armv7),不支持,建议升级硬件或上 OpenClaw Launch 托管版。
容器频繁重启怎么办?
docker logs openclaw 看错误。最常见的是网络问题(API 调用超时)— 配好代理一般就好。详见 OpenClaw 常见报错排查。
数据怎么备份?
所有数据都在 Compose 里挂载的 ./data 目录(实际路径在 NAS 上的项目文件夹下)。直接备份这个目录就行,包含配置、对话历史、记忆库。