连接账号
-
启动 Daemon 服务 并保持运行。
Terminal window wx serve -
在第二个终端中登录。
适用于所有支持的平台。agent-wechat 会在其独立的数据目录中创建一个全新的微信 Profile。
Terminal window wx accounts create --alias mewx auth login直接复用现有的 Linux 版微信文件以保留完整的本地聊天记录。操作前请先退出微信官方客户端并做好备份:
Terminal window tar -czf ~/wechat-profile-backup.tgz -C ~ xwechat_files .xwechatwx auth login --official--official默认扫描用户家目录。如果数据存放在其他位置,可指定所在目录路径:--official=/path/to/home。使用手机微信扫描终端打印的二维码。当终端提示正在等待确认时,在手机微信中点击同意登录。
使用
wx --json auth login时,等待确认的通知会作为 JSON 行输出到 stderr(附带event: "login.progress"与state: "awaiting_approval")。最终的操作结果将作为一个单独的 JSON 文档输出到 stdout。 -
验证连接状态。
Terminal window wx messages list filehelper --limit 1{"items": [{"id": "msg_eyJkYXRhYmFzZSI6Im1lc3NhZ2UvbWVzc2FnZV8wLmRi…","threadId": "filehelper","direction": "outgoing","type": 1,"body": "notes for Monday","createdAt": "2026-10-21T09:14:03+00:00"}],"nextCursor": "…"}
连接成功!下一步:配置在后台持续运行,然后通过 CLI、OpenClaw 或 HTTP API 尽情使用。
退出登录或删除 Profile
使用 wx accounts list 查看所有账号,并获取对应的账号 ID:
wx --account ACCOUNT_ID auth loginwx --account ACCOUNT_ID auth logout使用 wx --account ACCOUNT_ID auth logout --local 仅在守护进程本地登出并保留保存的登录凭据,无需向微信服务端发送登出注销请求。两种形式均会停止自动重连。
退出登录完成后,可通过确认相同的 ID 将该 Profile 从管理列表中注销:
wx accounts remove ACCOUNT_ID --confirm ACCOUNT_ID{ "accountId": "ACCOUNT_ID", "removed": true, "filesRetained": true }注销只会从管理记录中移除该 Profile,本地数据文件将安全保留。wx auth forget --yes 则是一项独立操作,仅用于清除已保存的登录凭据,不会删除 Profile 注册记录。