剪藏#剪藏#数据有道

群晖 NAS 部署 OpenClaw 指南

2026 年 4 月 3 日1 分钟
分享Twitter / XTelegram微博

容器养龙虾:群晖 NAS 部署 OpenClaw 指南(一)

环境:群晖 DS220+ / DSM 7.2 / 无公网独立 IP

一、准备工作

1. 开启 SSH 远程登录

路径: 控制面板 → 终端机和 SNMP → 终端机

  • ✅ 启用 SSH 功能

  • 端口:22(或自定义)

  • 点击"应用"

防火墙设置: 控制面板 → 安全性 → 防火墙

如果开了防火墙,记得放行 SSH 端口

二、创建目录结构

通过 SSH 登录群晖,执行:

JAVASCRIPT
ssh 你的用户名@群晖 IP

# 创建 OpenClaw 工作目录
sudo mkdir -p /volume1/docker/openclaw/data

# 设置权限(使用容器默认用户的 UID/GID
# 默认使用 node 用户:1000:100
# 默认使用 root 账号:0:0
sudo chown -R 1000:100 /volume1/docker/openclaw

三、创建 docker-compose.yml

JAVASCRIPT
cd /volume1/docker/openclaw
sudo vim docker-compose.yml

写入以下内容:

JAVASCRIPT
# ============================================================
# OpenClaw Docker Compose 配置
# ============================================================

version'3.8'
services:
  openclaw:
    # 官方镜像(英文原版)
    # image: ghcr.io/openclaw/openclaw:latest
    # 国内用户可替换为中文优化版
    image1186258278/openclaw-zh:latest
    
    # 自动下载最新版本的容器
    # pull_policy: always
    
    # 指定容器名称为 openclaw
    container_name: openclaw
    
    # 启用容器僵尸进程自动回收
    inittrue
    
    ports:
      - "18789:18789"
    
    volumes:
      # 数据持久化(容器以 root 用户运行)
      # 配置存储在 /root/.openclaw
      # rw 代表读写权限,ro 代表只读权限
      - /volume1/docker/openclaw/data:/root/.openclaw:rw
      
      # 时区配置(使用宿主机时区)
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
      
      # 挂载容器入口脚本
      - /volume1/docker/openclaw/data/initconfig/entrypoint.sh:/entrypoint.sh:rw
      
      # 个人数据挂载(可选)
      # - /volume1/homes/dx:/root/dx:rw
    
    environment:
      # 访问令牌(网页访问的认证 token)
      - OPENCLAW_GATEWAY_TOKEN=yourpassword
      
      # 本地化配置(让容器的 ssh 操作支持中文显示)
      - LANG=C.UTF-8
      - LC_ALL=C.UTF-8
      - TZ=Asia/Shanghai
      - HOME=/root
      
      # 跳过首次初始化检查(高级用户)
      # - OPENCLAW_SKIP_SETUP=1
    
    # 自动重启参数
    restart: unless-stopped
    
    # 容器的默认启动命令
    # 第一次启动选下面这行
    command: openclaw gateway run --allow-unconfigured
    
    # 如果不是第一次启动(已有现成 openclaw.json 配置)
    # command: openclaw gateway run
    
    # 还可以使用自定义入口脚本(与上面的 command 二选一)
    # entrypoint: /entrypoint.sh

镜像选择

ghcr.io/openclaw/openclaw:latest 官方原版 英文环境、追求最新
1186258278/openclaw-zh:latest 中文优化版 国内用户、中文界面

四、启动容器

JAVASCRIPT
cd /volume1/docker/openclaw

# 拉取镜像
sudo docker-compose pull

# 启动容器
sudo docker-compose up -d

# 删除容器(如需重新部署)
sudo docker-compose down -v

# 查看日志
sudo docker-compose logs -f

启动成功标志

看到类似以下输出表示启动成功:

JAVASCRIPT
openclaw | Server started on http://0.0.0.0:18179
openclaw | OpenClaw is ready!

五、访问 OpenClaw

浏览器访问:http://群晖 IP:18789

使用配置的 OPENCLAW_GATEWAY_TOKEN 进行认证

下一篇:OpenClaw 配置与技能安装

发布于: 容器养龙虾 标签: #OpenClaw #群晖 NAS #Docker #AI Agent

原文地址: https://mp.weixin.qq.com/s?__biz=MzAxOTk3NDU2MQ==&mid=2247483712&idx=1&sn=86e17af05dacfb6b62776382ea363133&chksm=9d3678d4d2a14ad285df29cb5236f17c4e110124866a32d062820213fa616eff53b0587ea3eb&mpshare=1&scene=1&srcid=0403qov6DA4hmBFDI9drFsJ3&sharer_shareinfo=7b9ed28e835e8f232203d393ff1f4687&sharer_shareinfo_first=7b9ed28e835e8f232203d393ff1f4687#rd

相关文章