开始 / Getting Started
安装与初始化
三步就能跑起来:一行装 → wechat-use init 抽一次 key → 绑激活码。让任意 AI agent 直接给你的微信发消息、读历史 —— 纯后台 LLDB,不走 UI 自动化,不重新扫码登录,用的还是你那台官方微信本体。(init 首次会给 WeChat 主程序打一次本地 ad-hoc 重签放开调试口,需 sudo,详见下方。)
- macOS 14+,Apple Silicon(M 系列)。Intel 机不支持。
- 微信 4.1.9 正在运行且已登录 —— 这是主力实测版本。
4.1.8也能用;4.1.10 暂不完美支持,建议留在 4.1.9 并关掉自动更新(下方「锁定 4.1.9」有官方安装包 + 关更新步骤)。 - 要输一次
sudo密码:init会开 Developer mode(DevToolsSecurity)+ 给 WeChat 主程序 ad-hoc 重签放开get-task-allow(腾讯官方签名禁 debugger,不重签挂不上)。只碰主二进制,不动wechat.dylib、bundle、登录态;微信自动更新后重跑init自动补。 send需要激活码,前缀wechatuse_,从 Telegram@WechatCliBot领。纯读命令(sessions/history等)不需要。- 把
~/.local/bin加进PATH(安装脚本装到这里)。
一、一行安装
不走 npm,不需要 token。从 GitHub Release 拉预编译二进制,自动清 Gatekeeper 隔离标记,装到 ~/.local/bin/wechat(别名 wechat-use)。
$ curl -fsSL https://raw.githubusercontent.com/leeguooooo/wechat-use/main/install.sh | bash装完确认一下能调到:
$ wechat-use doctor # 自检:LLDB / 辅助功能权限 / 微信版本 / key / daemon / 指纹wechat-use 提示 command not found,把 export PATH="$HOME/.local/bin:$PATH" 加进你的 ~/.zshrc 再开一个新终端。
二、init:一次性抽 SQLCipher key
微信本地库是 SQLCipher 加密的,wechat-use init 只在首次运行时把 key 取出来。它会重启微信,并在登录那一刻用一次 macOS 调试接口挂上去读 key,写进 ~/.wx-rs/。首次会要一次 sudo:开 Developer mode + 给 WeChat 主程序 ad-hoc 重签放开 get-task-allow(不重签 LLDB attach 不上)。重签只碰主可执行文件——不动 wechat.dylib、不改 bundle、不用重新扫码;微信自动更新覆盖签名后,重跑 init 自动补回。之后所有读命令都用本地 key 直接解密,不再碰进程。
$ wechat-use initwechat-use init --force 重来一次。每次微信重启后都要重跑 init(key 缓存会随进程失效)。
key 会写进 ~/.wx-rs/(权限 0600):4.1.7/4.1.8 是单一主 key(key.hex);4.1.9+ 是每库一把 key(keys.json + config.json)。取到后读库全程本地解密,不再挂进程。
发消息还要开辅助功能
只有 send 需要:在「系统设置 → 隐私与安全性 → 辅助功能」里给你的终端 App 打勾。跑一次 doctor 会直接弹出授权对话框并帮你打开设置面板。
$ wechat-use doctor三、绑激活码(发消息前必做)
从 Telegram @WechatCliBot 领一个 wechatuse_ 开头的激活码,绑到本机 —— token 存进 macOS Keychain。订阅校验在 daemon 内部强制执行(HTTP 401/402),绕不过。
$ wechat-use auth activate wechatuse_xxxxxxxx
$ wechat-use auth status # 看 tier / 剩余天数 / token 状态(已脱敏)四、跑一条 send 验证
建议先发给文件传输助手 filehelper,不打扰任何人。
$ wechat-use send "hello from wechat-use" filehelpersend 会返回 delivery_verify_timeout —— 这是正常的。你只需在微信里手动打一条消息 + 回车(比如发给 filehelper),把发送管线接通,之后再 send 就一路后台、零闪烁了。
五、锁定 4.1.9(推荐)
wechat-use 的主力实测版本是微信 4.1.9。4.1.10 目前不完美支持 —— 微信自动更新可能把你悄悄升上去,导致 send / init 失效。建议装官方 4.1.9 并关掉自动更新,把版本钉住。
4.1.9.52(未改动、官方签名)。腾讯 CDN 会删旧版,所以我们镜像一份长期可下:WeChat-4.1.9.dmg(466 MB)。下载后核对 sha256 再装:72a2557e9e440a73219d933b6faf7bc76550c7f75f3dfacea648afdf8eae4df3
# 0) 核对拿到的是官方包(应等于上面的 sha256)
$ shasum -a 256 ~/Downloads/WeChat-4.1.9.dmg
# 1) 退出微信 → 挂载 DMG → 把 WeChat.app 拖进 /Applications 覆盖
# 登录态和聊天记录在 ~/Library/Containers 里,换 .app 不影响
# 2) 关掉微信自动更新(二选一)
$ wechat-use update-guard disable # 锁住 MacUpdate 路径
# 或 GUI:WeChat → 设置 → 通用 → 关闭「有更新时自动升级」
# 3) 自检确认版本 + 通道
$ wechat-use doctorwechat-use update-guard disable 关更新,退出微信,再用上面的 4.1.9 DMG 覆盖安装,重新 wechat-use init 即可 —— 数据都在容器里,不会丢。想恢复自动更新用 wechat-use update-guard enable。