OpenClaw 装进QNAP威联通NAS:Container Station可视化界面安装AI全家桶
教程说明:本文专为 QNAP 威联通 NAS 用户打造。如果你的 NAS 已经 24 小时开机,何不让它同时运行一个 AI 智能体?本文介绍通过 QNAP Container Station(图形化界面)安装和管理 OpenClaw 的完整流程,全程几乎不需要敲命令,鼠标操作即可完成。支持 QNAP x86 和 ARM 机型(部分限制请见正文)。
为什么 NAS 是运行 OpenClaw 的理想设备
你的 NAS 可能已经 24 小时不间断运行了——存储文件、备份数据、下载任务……但它的 CPU 和内存大部分时间都在闲置。把 OpenClaw 部署在 NAS 上,相当于免费获得了一台常驻 AI 服务器,额外电力消耗几乎可以忽略不计。
与其他方案相比,NAS 部署 OpenClaw 有几个独特优势:无需额外采购服务器、7×24 小时稳定在线、与 NAS 现有文件系统深度整合(AI 可以直接访问你的文档和照片)、噪音极低功耗极小,放在家里完全不影响生活。
QNAP 机型兼容性说明
在开始之前,先确认你的 QNAP NAS 是否支持本教程的安装方式:
| 机型类别 | 兼容性 | 备注 |
|---|---|---|
| x86 机型(Intel/AMD CPU) | 完全支持 | TS-453D, TS-673A, TVS-h1288X 等 |
| ARM 64位机型 | 部分支持 | 需使用 ARM64 兼容镜像,TS-233, TS-433 等 |
| ARM 32位机型(老款) | 不支持 | Node.js 22 不支持 ARMv7 及以下 |
| QTS 版本 | QTS 5.1+ | Container Station 3.0 需要 QTS 5.1 或以上 |
方法一:Container Station 图形化安装(推荐)
QNAP Container Station 是 QNAP 官方的 Docker 管理界面,可以通过浏览器图形化操作创建和管理容器,完全不需要敲命令行。
安装 Container Station
打开 QNAP 管理界面 → App Center → 搜索 "Container Station" → 安装。如果已安装,确认版本为 3.0 或以上(支持 Compose 管理)。
打开 Container Station → 创建
在主菜单点击 创建,选择 创建应用程序(使用 Docker Compose),进入 Compose 编辑界面。
粘贴 docker-compose.yml 配置
在编辑框中粘贴以下配置(将 API Key 和 Bot Token 替换为你的实际值):
version: '3.8'
services:
openclaw:
image: node:22-alpine
container_name: openclaw
restart: unless-stopped
environment:
- ANTHROPIC_API_KEY=sk-ant-api03-你的密钥
- HTTP_PROXY=http://host.docker.internal:7890
- HTTPS_PROXY=http://host.docker.internal:7890
ports:
- "18789:18789"
volumes:
- /share/homes/admin/.openclaw:/root/.openclaw
command: sh -c "npm install -g openclaw@latest && openclaw start"
extra_hosts:
- "host.docker.internal:host-gateway"
点击"验证"后"创建"
Container Station 会先验证 Compose 配置格式,验证通过后点击创建。首次运行会下载 Node.js 镜像(约 200MB),请耐心等待约 3-5 分钟。
方法二:SSH 命令行安装(进阶用户)
如果你熟悉命令行,可以通过 SSH 直接在 QNAP 上操作。先在 QNAP 控制台 → 网络与文件服务 → Telnet/SSH 中开启 SSH 服务。
# QNAP 已内置 Docker,直接创建 docker-compose 文件
mkdir -p /share/homes/admin/openclaw
cd /share/homes/admin/openclaw
# 创建 docker-compose.yml(使用 vi 编辑器)
vi docker-compose.yml
# 启动容器
docker-compose up -d
# 查看运行日志
docker-compose logs -f
首次初始化配置
容器启动后,需要进入容器内部完成 OpenClaw 的 onboard 初始化(只需做一次):
# 进入容器内部
docker exec -it openclaw sh
# 在容器内运行初始化向导
openclaw onboard
# 按提示输入:AI名字、API Key、Telegram Bot Token
# 完成后 Ctrl+D 退出容器
Container Station 里的可视化操作
在 Container Station 中,你可以直接点击容器名称 → "执行" → 选择 Shell,在图形界面中打开终端执行 onboard 命令,无需单独 SSH 连接。
配置 QNAP 反向代理(从外网访问控制面板)
QNAP 内置了反向代理功能,可以通过 HTTPS 从外网安全访问 OpenClaw 控制面板,不需要安装额外的 Nginx:
进入 QNAP 控制台 → 网络与文件服务 → 反向代理服务器
点击 添加,规则名称填 "openclaw",来源监听端口填 8080(或其他未占用端口),目标填 http://127.0.0.1:18789
如果有 Let's Encrypt 证书,可以开启 HTTPS,实现安全的加密访问
完成后,通过 http://你的NAS-IP:8080 访问 OpenClaw 控制面板
日常管理:Container Station 可视化操作
重启/停止
在 Container Station 容器列表中,点击 openclaw 容器右侧的操作按钮,可以一键重启、停止或删除容器,完全图形化操作。
查看日志
点击容器名称 → "日志"标签,可以看到 OpenClaw 的实时运行日志,AI 的每次调用、错误信息都会在这里显示。
资源监控
Container Station 首页可以看到每个容器的 CPU、内存占用。OpenClaw 待机时 CPU 占用通常低于 0.5%,内存约 150-200MB。
更新 OpenClaw
进入容器执行 shell → 运行 npm update -g openclaw 即可更新到最新版,无需重建容器。
常见问题解答
❌ 容器启动后 API 调用总是超时
原因:Docker 容器访问宿主机 VPN 代理需要特殊配置。检查 docker-compose.yml 中的 extra_hosts 和 HTTP_PROXY 是否配置了 host.docker.internal,这是 Docker 容器访问宿主机的标准方式。
⚠️ ARM 机型找不到可用镜像
解决:将 docker-compose.yml 中的 node:22-alpine 改为 node:22-alpine3.19(明确指定版本),Container Station 会自动拉取对应 ARM64 架构的镜像。
💡 NAS 重启后容器不自动启动
检查 docker-compose.yml 中 restart 策略是否设置为 unless-stopped。另外也可以在 Container Station 中找到应用,勾选"开机自动启动"选项。
✅ 如何访问 NAS 里的文件
在 docker-compose.yml 的 volumes 中添加 NAS 目录映射,例如 /share/CACHEDEV1_DATA/documents:/data/documents,OpenClaw 就可以直接读取和操作这些文件了。
VPN07 — NAS 上 OpenClaw 的网络保障
家庭网络首选 · 路由器客户端支持 · 全家设备统一加速
NAS 上的 OpenClaw 需要访问境外 AI API,最优雅的解决方案是在家用路由器上安装 VPN07——这样局域网内包括 NAS 在内的所有设备都自动走代理,无需单独配置。VPN07 运营十年,支持主流路由器固件(OpenWrt、梅林、Padavan),1000Mbps 千兆带宽保证 API 调用不超时,70+ 国家节点随时切换。月费仅 ¥9,让你的 NAS 变身全天候 AI 服务器。