跳转到内容

从旧容器迁移

0.x 版本在 Docker 容器内运行 Linux 版微信桌面程序并通过驱动图形界面进行操作。Native Daemon 则直接与微信底层协议交互,并能直接沿用原有的 Profile 数据文件,因此你的登录会话和历史记录都能完整保留。

停止并备份 wx auth login --official 0.x 容器微信桌面程序 + UI 服务 Profile 目录包含登录与历史 wx serve宿主机或新容器
  1. 找到原 Profile 目录。 该目录即原容器的主目录:通常为 Bind Mount 挂载目录或 Named Volume 数据卷。

    Terminal window
    docker inspect OLD_CONTAINER --format '{{json .Mounts}}'
  2. 停止旧容器并备份数据。 停止前请确保所有进行中的发送已结束。请妥善保存原容器及数据卷,切勿直接删除。

    Terminal window
    docker stop OLD_CONTAINER
    # 若为 Named Volume 数据卷:
    docker run --rm -v OLD_VOLUME:/src:ro -v "$PWD":/out busybox \
    tar -czf /out/wechat-profile-backup.tgz -C /src .
    # 若为 Bind Mount 挂载目录:
    tar -czf wechat-profile-backup.tgz -C /path/to/old/bind-mount .
  3. 将 Native Daemon 指向该 Profile。

    安装 wx,启动 wx serve,然后在第二个终端中执行:

    Terminal window
    wx auth login --official=/path/to/old/bind-mount

    如果原本使用的是 Named Volume,请先将其解压复制到宿主机的某个目录,或参考下方的容器方案。

  4. 在修改其他配置前,先验证聊天记录和联系人。

    Terminal window
    wx accounts list
    wx messages list filehelper --limit 5
  5. 更新 OpenClaw 配置(如果使用了 OpenClaw)。将旧版的 serverUrl 与 token 配置替换为 native 配置块,参考 OpenClaw 快速接入。移除旧的 serverUrl、token、pollIntervalMs 以及 authPollIntervalMs。保留 dmPolicy、allowFrom 和 groups 设置,在通道启动后确认功能正常。

版本变更对照

0.x 版本1.x 原生版本
wx up / wx down 管理容器wx serve 或 wx daemon start
API 路径为 /apiAPI 路径为 /v1,具备全新路由与 ID 规范。详见 HTTP API。
OpenClaw 配置 serverUrl + tokenOpenClaw 配置 native 块与令牌引用
屏幕截图、VNC 桌面、窗口焦点选择已移除;Daemon 纯协议运行,无图形界面
Wechaty puppet 支持已废弃并归档
代理网络配置暂不支持