跳转到内容

数据存储与备份

~/.config/agent-wechat/
├── server/config.toml 服务端配置 (可选)
└── client.toml CLI 客户端:已保存的服务器列表与默认账号
~/.local/share/agent-wechat/ 数据目录
├── api-token 管理员所有者 API 访问令牌
└── accounts/<id>/
├── profile/ 微信 Profile:聊天记录、联系人、媒体文件
└── agent/
├── control.sqlite 登录凭据、任务、事件日志
└── media/ 加密的附件与上传文件
$TMPDIR 离线检查用的临时只读快照

在 Windows 上,配置文件位于 %APPDATA%\agent-wechat,数据文件位于 %LOCALAPPDATA%\agent-wechat。macOS 采用与 Linux 一致的路径标准。

如果你是通过 --official 登录的,则不会生成 profile/ 文件夹:Daemon 会直接使用 Linux 版微信所在的 ~/xwechat_files 与 ~/.xwechat(位于它们原本的位置),数据目录中只保留 Daemon 自己的文件。

附件存放位置

附件存放位置
图片、文件、视频和语音消息仅保存在微信 Profile 中,Daemon 从该处读取。
表情、链接缩略图,以及引用消息中的图片和表情agent/media/,每个文件单独加密。Profile 中没有对应的位置。
待发送的文件agent/media/,直到使用它们的所有发送任务完成后一天。

如果删除了附件的文件,获取该附件时将返回 media_not_cached。Daemon 不会自行重新下载。

数据备份方案

先停止 Daemon 服务(执行 wx daemon stop、systemctl --user stop agent-wechat-native 或 docker compose stop),然后打包备份数据目录:

Terminal window
tar -czf wechat-backup.tgz -C ~ .local/share/agent-wechat

对于使用 --official 挂载官方目录的用户,需在打包命令中连同 xwechat_files .xwechat 一并备份。仅仅备份 Profile 目录会丢失在途发送记录、OpenClaw 处理位点以及撤回标记;仅仅备份数据目录则没有任何聊天历史记录。

修改数据路径

可以在 ~/.config/agent-wechat/server/config.toml 中配置 dataDir,或在启动命令中显式传递 --data-dir 参数。详见配置选项。