数据存储与备份
~/.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),然后打包备份数据目录:
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 参数。详见配置选项。