NAS Docker 环境下 OpenClaw 一键自动化部署脚本以及部署教程

cat << 'EOF' > install_openclaw.sh
#!/bin/bash

# ================= 配置区域 =================
# 建议在此处根据你的实际网络环境进行微调
TARGET_IP="172.20.0.18"        # 容器固定 IP (请确保该 IP 未被占用)
GATEWAY="172.20.0.1"           # 你的主路由网关地址
SUBNET="172.20.0.0/24"         # 你的内网子网范围
DATA_DIR="/volume1/docker/openclaw" # 数据存储路径
IMAGE="ghcr.io/openclaw/openclaw:latest"
# ===========================================

echo ">>> [1/9] 开始执行 OpenClaw 自动化部署流程 (HTTP 修复版)..."

# 1. 网卡智能检测
# 群晖开启 VMM 后网卡名会变为 ovs_eth0，这里进行兼容性处理
if ip link show "ovs_eth0" > /dev/null 2>&1; then
    INTERFACE="ovs_eth0"
    echo "✅ 检测到群晖虚拟交换机，强制绑定物理接口: $INTERFACE"
else
    INTERFACE="eth0"
    echo "⚠️ 未检测到 ovs_eth0，降级绑定物理接口: $INTERFACE"
fi

# 2. 清理旧环境
echo ">>> [2/9] 清理旧容器实例..."
if docker ps -a | grep -q "openclaw"; then
    docker rm -f openclaw > /dev/null 2>&1
    echo "✅ 旧容器已强制移除"
else
    echo "✅ 无旧容器，跳过清理"
fi

# 3. 目录准备
echo ">>> [3/9] 配置数据持久化目录..."
if [ -d "$DATA_DIR" ]; then
    echo "📂 检测到现有目录: $DATA_DIR"
else
    mkdir -p "$DATA_DIR"
    echo "📂 新建目录: $DATA_DIR"
fi

CONFIG_DIR="$DATA_DIR/config"
WORKSPACE_DIR="$DATA_DIR/workspace"
mkdir -p "$CONFIG_DIR" "$WORKSPACE_DIR"

# 3.1 强制权限修正
# 这里直接给 777 是为了规避群晖复杂的 ACL 权限导致容器内 Node 进程无权写入
echo ">>> [3.1/9] 正在执行权限修正 (chmod 777)..."
chmod -R 777 "$DATA_DIR"

# ========================================================
# 3.2 核心修复：强制生成 openclaw.json
# 这是解决 1006 错误的关键：物理写入配置，允许 HTTP Token 登录
# 很多人在 Web UI 无法进入时根本没法改这个设置，所以我们先发制人
# ========================================================
echo ">>> [3.2/9] 正在生成 openclaw.json (强制开启非安全认证)..."
cat << JSONEOF > "$CONFIG_DIR/openclaw.json"
{
  "gateway": {
    "controlUi": {
      "allowInsecureAuth": true
    }
  }
}
JSONEOF
# 再次修正文件权限，确保容器内 Node 用户可读
chmod 666 "$CONFIG_DIR/openclaw.json"
echo "✅ 配置文件已写入: $CONFIG_DIR/openclaw.json"

# 4. Macvlan 网络构建
echo ">>> [4/9] 检查 Docker Macvlan 网络栈..."
if docker network inspect macvlan_net >/dev/null 2>&1; then
    echo "✅ 网络 macvlan_net 已存在，直接复用"
else
    echo "🔨 创建 Docker Macvlan 网络 (Parent: $INTERFACE)..."
    docker network create -d macvlan \
      --subnet=$SUBNET \
      --gateway=$GATEWAY \
      -o parent=$INTERFACE \
      macvlan_net || { echo "❌ 网络创建失败！请检查子网是否冲突"; exit 1; }
fi

# 5. 安全令牌生成
# 随机生成一个 32 位的 Hex 字符串作为 Gateway Token
echo ">>> [5/9] 生成 Gateway Token..."
if command -v openssl > /dev/null 2>&1; then
    GATEWAY_TOKEN=$(openssl rand -hex 32)
else
    GATEWAY_TOKEN=$(python3 -c "import secrets; print(secrets.token_hex(32))")
fi
echo "🔑 Token 生成完毕"

# 6. 启动容器
# 注意：这里我们覆盖了默认的 CMD，加入了 --bind lan 和 --allow-unconfigured
echo ">>> [6/9] 正在启动 OpenClaw 容器 (IP: $TARGET_IP)..."
echo "⚙️  配置模式: 本地 openclaw.json 优先"

docker run -d \
    --name openclaw \
    --restart always \
    --network macvlan_net \
    --ip $TARGET_IP \
    -e HOME=/home/node \
    -e TERM=xterm-256color \
    -e OPENCLAW_GATEWAY_TOKEN="$GATEWAY_TOKEN" \
    -v "$CONFIG_DIR":/home/node/.openclaw \
    -v "$WORKSPACE_DIR":/home/node/.openclaw/workspace \
    --init \
    $IMAGE \
    node dist/index.js gateway --bind lan --port 18789 --allow-unconfigured

# 7. 健康检查等待
echo ">>> [7/9] 等待服务初始化 (15秒)..."
sleep 15

# 8. 验证配置文件生效情况
echo ">>> [8/9] 验证配置注入..."
if docker exec openclaw ls -l /home/node/.openclaw/openclaw.json > /dev/null 2>&1; then
    echo "✅ 配置文件 openclaw.json 已成功挂载"
else
    echo "⚠️ 警告：容器内未检测到配置文件，可能导致连接失败"
fi

# 9. 最终状态
if docker ps | grep -q "openclaw"; then
    echo "✅ OpenClaw 容器运行状态: [正常]"
else
    echo "❌ 容器启动失败，查看日志: docker logs openclaw"
    exit 1
fi

echo "========================================================"
echo "🚀 OpenClaw 部署成功 (HTTP 1006 修复补丁已应用)"
echo "========================================================"
echo "⚠️  重要提示：由于使用 HTTP 协议，必须使用下方完整链接访问！"
echo ""
echo "👉 复制此链接到浏览器 (建议使用无痕模式):"
echo "   http://$TARGET_IP:18789/?token=$GATEWAY_TOKEN"
echo ""
echo "📋 操作说明:"
echo "   1. 必须带上 ?token=... 参数，否则浏览器会拦截配对"
echo "   2. 建议先清理浏览器缓存或使用隐身窗口打开"
echo "   3. 进入后如果仍提示连接断开，请检查 Token 是否正确填入设置页"
echo "========================================================"

rm -- "$0"
EOF

chmod +x install_openclaw.sh && ./install_openclaw.sh

docker exec -it openclaw sh

./openclaw.mjs onboard