跳转到内容

连接账号

  1. 启动 Daemon 服务 并保持运行。

    Terminal window
    wx serve
  2. 在第二个终端中登录。

    适用于所有支持的平台。agent-wechat 会在其独立的数据目录中创建一个全新的微信 Profile。

    Terminal window
    wx accounts create --alias me
    wx auth login

    使用手机微信扫描终端打印的二维码。当终端提示正在等待确认时,在手机微信中点击同意登录。

    使用 wx --json auth login 时,等待确认的通知会作为 JSON 行输出到 stderr(附带 event: "login.progress" 与 state: "awaiting_approval")。最终的操作结果将作为一个单独的 JSON 文档输出到 stdout。

    终端展示 wx auth login 打印二维码并成功确认登录的流程
  3. 验证连接状态。

    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:

Terminal window
wx --account ACCOUNT_ID auth login
wx --account ACCOUNT_ID auth logout

使用 wx --account ACCOUNT_ID auth logout --local 仅在守护进程本地登出并保留保存的登录凭据,无需向微信服务端发送登出注销请求。两种形式均会停止自动重连。

退出登录完成后,可通过确认相同的 ID 将该 Profile 从管理列表中注销:

Terminal window
wx accounts remove ACCOUNT_ID --confirm ACCOUNT_ID
{ "accountId": "ACCOUNT_ID", "removed": true, "filesRetained": true }

注销只会从管理记录中移除该 Profile,本地数据文件将安全保留。wx auth forget --yes 则是一项独立操作,仅用于清除已保存的登录凭据,不会删除 Profile 注册记录。