群晖 Container Manager 部署 OpenClaw 完整教程（避坑版）

前言

OpenClaw 是一款强大的 AI 助手集成工具，支持对接飞书、QQ、微信等多渠道，非常适合在群晖 NAS 上 24 小时稳定运行。本文将基于官方 Docker 文档，结合群晖环境特性，提供一份从 0 到 1 的部署指南，并解决你遇到的镜像拉取权限拒绝等常见问题。

一、环境准备

1. 硬件与系统要求

• 群晖 NAS（DSM 7.0 及以上版本）

• 至少 4GB 内存（推荐 8GB+，适配 3080 20G 显卡本地模型）

• 已安装 Container Manager（原 Docker 套件）

2. 目录结构规划

在 File Station 中创建以下目录结构，用于数据持久化：

Text

/volume1/openclaw/
├── data/          # 配置文件、数据库等持久化数据
└── workspace/     # 工作区文件映射

3. 配置镜像加速器（国内环境必备）

为提升镜像下载速度，避免超时，建议先配置国内镜像源：

1. 打开 Container Manager → 设置 → Docker引擎

2. 在 registry-mirrors 数组中添加以下地址：

   {
     "registry-mirrors": [
       "https://docker.mirrors.ustc.edu.cn",
       "https://hub-mirror.c.163.com"
     ]
   }

3. 点击 保存并应用，重启 Docker 服务。

---

二、Docker Compose 部署（推荐）

1. 新建项目

1. 进入 Container Manager → 项目 → 新建

2. 填写项目信息：

   • 项目名称：openclaw

   • 路径：选择 /volume1/openclaw

   • 源代码：选择 创建 docker-compose.yml

2. 编写 Compose.yaml 配置

将以下内容完整粘贴到编辑器中（已修复镜像权限问题）：

version: '3.8'

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:main-slim-amd64
    container_name: openclaw-gateway
    restart: always
    ports:
      - "18789:18789"  # 主端口
      - "18790:18790"  # 备用端口
    volumes:
      - /volume1/docker/openclaw/data:/home/node/.openclaw  # 持久化配置与数据
      - /volume1/docker/openclaw/workspace:/workspace       # 工作区映射
    environment:
      - NODE_ENV=production
      - OPENCLAW_CONFIG=/home/node/.openclaw/config.json
      - TZ=Asia/Shanghai  # 时区设置（重要）
    shm_size: '2gb'  # 群晖关键配置，防止内存不足
    command: openclaw gateway --port 18789 --allow-unconfigured  # 允许未配置启动

  openclaw-cli:
    image: ghcr.io/openclaw/openclaw:main-slim-amd64
    container_name: openclaw-cli
    restart: always
    volumes:
      - /volume1/docker/openclaw/data:/home/node/.openclaw
      - /volume1/docker/openclaw/workspace:/workspace
    network_mode: 'service:openclaw-gateway'  # 共享网关网络，避免端口冲突
    depends_on:
      - openclaw-gateway
    command: tail -f /dev/null  # 保持容器运行，方便执行命令

3. 启动项目

1. 点击 下一步 → 确认配置 → 点击 完成

2. Container Manager 将自动拉取镜像并启动容器，耐心等待拉取完成。

⚠️ 若遇到 pull access denied 错误，请确保镜像地址为 ghcr.io/openclaw/openclaw:main-slim-amd64，切勿使用阿里云私有镜像。

---

三、初始化配置（容器内操作）

1. 进入 CLI 容器终端

1. 进入 Container Manager → 容器

2. 选择 openclaw-cli 容器 → 点击 详情 → 终端 → 新增 → 选择 /bin/sh

2. 执行初始化命令

在终端中依次执行以下命令：

# 1. 生成初始配置（按提示选择）
openclaw init

# 2. 安装需要的渠道插件（示例）
openclaw plugins install @openclaw/feishu  # 飞书
openclaw plugins install @openclaw/qq      # QQ
openclaw plugins install @openclaw/wechat  # 微信

# 3. 配置渠道（以飞书为例）
openclaw config set channels.feishu.appId "你的飞书AppID"
openclaw config set channels.feishu.appSecret "你的飞书AppSecret"

# 4. 配置AI后端（如本地Ollama）
openclaw config set agents.defaults.model "llama2"
openclaw config set agents.defaults.baseURL "http://你的NAS_IP:11434/v1"

# 5. 配置跨域（群晖访问关键）
openclaw config set controlui.allowedOrigins '["http://你的NAS_IP:18789", "http://127.0.0.1:18789"]'

# 6. 重启网关生效
openclaw gateway restart

---

四、访问与验证

1. Web 控制台访问

在浏览器中输入：

Text

http://你的NAS_IP:18789

首次访问将进入配置向导，完成剩余设置后即可使用 OpenClaw 控制台。

2. 服务状态检查

在 openclaw-cli 终端中执行：

# 查看网关运行状态
openclaw gateway status

# 查看已安装插件列表
openclaw plugins list

---

五、常见问题排查

1. 镜像拉取权限拒绝（pull access denied）

• 原因：使用了阿里云私有镜像源，无访问权限。

• 解决：将 docker-compose.yml 中的镜像地址替换为 ghcr.io/openclaw/openclaw:main-slim-amd64。

2. 容器权限不足（文件读写错误）

• 原因：群晖默认权限严格，容器内用户无法读写映射目录。

• 解决：通过 SSH 登录群晖，执行以下命令授权：

  sudo chmod -R 777 /volume1/openclaw/data
  sudo chmod -R 777 /volume1/openclaw/workspace

3. 内存不足导致容器崩溃

• 原因：群晖环境默认共享内存过小。

• 解决：确保 docker-compose.yml 中已配置 shm_size: '2gb'。

4. 无法访问 Web 控制台

• 原因：群晖防火墙未放行 18789 端口。

• 解决：

  1. 打开 控制面板 → 安全性 → 防火墙

  2. 新增规则：允许 TCP 协议的 18789 端口访问。

---

六、升级与备份

1. 升级 OpenClaw

• 方法一：在 openclaw-cli 终端执行 openclaw upgrade

• 方法二：在 Container Manager 中，选择 openclaw 项目 → 操作 → 重新创建（勾选“拉取最新镜像”）

2. 备份数据

1. 停止 openclaw 项目

2. 复制 /volume1/openclaw/data 目录至备份位置

3. 恢复时，将备份目录覆盖回原路径即可。

---

结语

通过以上步骤，你已成功在群晖 NAS 上部署了 OpenClaw AI 助手。结合你的 3080 20G 显卡，可进一步对接本地大模型（如 Qwen、DeepSeek），实现高效的本地 AI 服务。

---

🔗 参考资料

• OpenClaw 官方文档

• 群晖 Container Manager 官方指南

---