docker升级openclaw版本

Docker容器内OpenClaw升级指南

在Docker环境中升级OpenClaw服务时，首要步骤是确保以root用户权限进入容器。默认的docker run命令会使用node用户身份启动，这可能导致后续文件操作时出现权限不足的问题。因此，请务必在命令中加入-u root参数来获取完整的管理员权限。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

成功进入容器后，您可以按顺序执行以下命令，以完成OpenClaw的完整升级流程：

# 1. 强制安装最新版并覆盖旧链接
npm install -g openclaw@latest --force --registry=https://registry.npmmirror.com
# 2. 建立目录软链接（将 npm 全局路径映射到 app 工作目录）
rm -rf /app/dist /app/node_modules
ln -sf /usr/local/lib/node_modules/openclaw/dist /app/dist
ln -sf /usr/local/lib/node_modules/openclaw/node_modules /app/node_modules
# 3. 清理旧版模型缓存（激活 128k 规格的关键）
rm -f /root/.openclaw/models.json
# 4. 权限归属与启动
chown -R node:node /root/.openclaw
exec node /app/dist/index.js gateway

请注意一个关键细节：通过npm install命令升级OpenClaw Gateway后，Web UI的前端静态文件并不会自动更新指向新版本目录/usr/local/lib/node_modules/openclaw/dist。这会导致即使命令行检查openclaw --version显示版本已更新，您访问的Web管理界面可能仍是旧版界面。解决此问题的核心方法是手动创建软链接，将新版本的资源目录覆盖到容器内原有的应用路径上。

常见升级问题与解决方案

在升级OpenClaw的过程中，您可能会遇到以下几个典型错误。下表汇总了问题的现象、原因及对应的解决方法：

OpenClaw服务重建与恢复

如果因误操作导致OpenClaw服务无法正常启动，您无需担心数据丢失。可以通过以下Docker启动命令，快速重建一个基于最新版OpenClaw镜像的容器。此命令模拟了官方docker-setup.sh脚本的完整流程，包括拉取openclaw:local镜像并完成初始化配置。

docker run -d \
--name openclaw-prod \
--restart unless-stopped \
-u root \
--memory=8g \
-p 18789:18789 \
-p 18790:18790 \
-v /root/.openclaw:/root/.openclaw \
-v /root/.openclaw/workspace:/root/.openclaw/workspace \
-e NODE_ENV=production \
-e NODE_OPTIONS="--max-old-space-size=4096" \
--entrypoint "/bin/sh" \
openclaw:local \
-c "npm install -g openclaw@latest --force --registry=https://registry.npmmirror.com && \
rm -rf /app/dist /app/node_modules && \
ln -sf /usr/local/lib/node_modules/openclaw/dist /app/dist && \
ln -sf /usr/local/lib/node_modules/openclaw/node_modules /app/node_modules && \
exec node /app/dist/index.js gateway"

在重建或配置服务时，openclaw.json配置文件中的gateway部分是核心，它定义了网关服务的关键参数。一个标准的配置结构示例如下：

"gateway": {
  "port": 18789,
  "mode": "local",
  "bind": "lan",
  "controlUi": {
    "enabled": true,
    "allowedOrigins": [
      "http://物理机ip:18789",
      "http://127.0.0.1:18789",
      "http://localhost:18789"
    ],
    "dangerouslyAllowHostHeaderOriginFallback": true,
    "allowInsecureAuth": true,
    "dangerouslyDisableDeviceAuth": true
  },
  "auth": {
    "mode": "token",
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" #gateway授权token
  },
  "trustedProxies": ["192.168.65.0/24", "172.18.0.0/16"],
  "tailscale": {
    "mode": "off",
    "resetOnExit": false
  },
  "nodes": {
    "denyCommands": [
      "camera.snap",
      "camera.clip",
      "screen.record",
      "contacts.add",
      "calendar.add",
      "reminders.add",
      "sms.send"
    ]
  }
},

此外，配置文件中的tools部分同样至关重要，它管理着工具调用的行为模式与安全策略。典型的配置示例如下：

"tools": {
  "profile": "coding",
  "exec": {
    "host": "gateway",
    "security": "full",
    "ask": "on-miss"
  }
},