开始 / Getting Started

安装与初始化

三步就能跑起来:一行装 → wechat-use init 抽一次 key → 绑激活码。让任意 AI agent 直接给你的微信发消息、读历史 —— 纯后台 LLDB,不碰 UI,不重签 WeChat.app,不重新登录。

⚠️ 前置条件(硬性,先对一遍)

macOS 14+,Apple Silicon(M 系列)。Intel 机不支持。
微信 4.0.x / 4.1.x 正在运行且已登录 —— 4.1.8 / 4.1.9 已实测验证。
send 需要激活码,前缀 wechatuse_,从 Telegram @WechatCliBot 领。纯读命令(sessions/history 等)不需要。
把 ~/.local/bin 加进 PATH(安装脚本装到这里)。

一、一行安装

不走 npm,不需要 token。从 GitHub Release 拉预编译二进制,自动清 Gatekeeper 隔离标记,装到 ~/.local/bin/wechat(别名 wechat-use)。

bash

$ curl -fsSL https://raw.githubusercontent.com/leeguooooo/wechat-use/main/install.sh | bash

装完确认一下能调到:

bash

$ wechat-use doctor   # 自检:LLDB / 辅助功能权限 / 微信版本 / key / daemon / 指纹

📝 关于 PATH

如果 wechat-use 提示 command not found,把 export PATH="$HOME/.local/bin:$PATH" 加进你的 ~/.zshrc 再开一个新终端。

微信本地库是 SQLCipher 加密的,wechat-use init 只在首次运行时把 key 取出来。它会重启微信,并在登录那一刻用一次 macOS 调试接口挂上去读 key —— 不需要 sudo,不重签 WeChat.app,不改 bundle,也不用重新扫码。

bash

$ wechat-use init

⚠️ 有个 5 分钟窗口要点确认

init 会重启微信到登录界面,你必须在大约 5 分钟内点「进入 WeChat」,key 才能在那一刻抓到。错过了就用 wechat-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 会直接弹出授权对话框并帮你打开设置面板。

bash

$ wechat-use doctor

从 Telegram @WechatCliBot 领一个 wechatuse_ 开头的激活码,绑到本机 —— token 存进 macOS Keychain。订阅校验在 daemon 内部强制执行(HTTP 401/402),绕不过。

bash

$ wechat-use auth activate wechatuse_xxxxxxxx
$ wechat-use auth status   # 看 tier / 剩余天数 / token 状态(已脱敏)

建议先发给文件传输助手 filehelper,不打扰任何人。

bash

$ wechat-use send "hello from wechat-use" filehelper

✅ 首次 send 需要 warmup 一次

微信每次重启后的第一条 send 会返回 delivery_verify_timeout —— 这是正常的。你只需在微信里手动打一条消息 + 回车(比如发给 filehelper),把发送管线接通,之后再 send 就一路后台、零闪烁了。