从旧容器迁移
0.x 版本在 Docker 容器内运行 Linux 版微信桌面程序并通过驱动图形界面进行操作。Native Daemon 则直接与微信底层协议交互,并能直接沿用原有的 Profile 数据文件,因此你的登录会话和历史记录都能完整保留。
-
找到原 Profile 目录。 该目录即原容器的主目录:通常为 Bind Mount 挂载目录或 Named Volume 数据卷。
Terminal window docker inspect OLD_CONTAINER --format '{{json .Mounts}}' -
停止旧容器并备份数据。 停止前请确保所有进行中的发送已结束。请妥善保存原容器及数据卷,切勿直接删除。
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 . -
将 Native Daemon 指向该 Profile。
安装
wx,启动wx serve,然后在第二个终端中执行:Terminal window wx auth login --official=/path/to/old/bind-mount如果原本使用的是 Named Volume,请先将其解压复制到宿主机的某个目录,或参考下方的容器方案。
参考 Compose 示例,将旧数据卷挂载进新服务:
services:agent-wechat-native:volumes:- old-home:/profiles/wechatvolumes:old-home:external: truename: YOUR_OLD_VOLUMETerminal window wx --server-name box auth login --official=/profiles/wechat -
在修改其他配置前,先验证聊天记录和联系人。
Terminal window wx accounts listwx messages list filehelper --limit 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 路径为 /api | API 路径为 /v1,具备全新路由与 ID 规范。详见 HTTP API。 |
OpenClaw 配置 serverUrl + token | OpenClaw 配置 native 块与令牌引用 |
| 屏幕截图、VNC 桌面、窗口焦点选择 | 已移除;Daemon 纯协议运行,无图形界面 |
| Wechaty puppet 支持 | 已废弃并归档 |
| 代理网络配置 | 暂不支持 |