开始 / Getting Started

wechat-use

让任意 AI agent 直接给你的微信发消息、读历史 —— 纯后台 LLDB,不碰 UI,不重签 WeChat.app,不重新登录。发出去的每条消息、读到的每把 key,都来自你本机那个已经登录好的正版微信本体。「就是你的真微信」→

装它

bash

# macOS 14+ / Apple Silicon / WeChat 4.1.8·4.1.9,一行装到 ~/.local/bin/wechat
$ curl -fsSL https://raw.githubusercontent.com/leeguooooo/wechat-use/main/install.sh | bash

# 首次抽 key(重启微信,登录时点「进入 WeChat」;无 sudo,不重签)
$ wechat-use init

# 绑激活码(找 @WechatCliBot 领 wechatuse_ 码),然后发第一条
$ wechat-use auth activate wechatuse_xxxxx
$ wechat send "你好" filehelper

它能干什么

🔑

一次性抽 key,不重签

init 用 macOS 调试接口取一次 SQLCipher key,写进 ~/.wx-rs/。无 sudo、不重签 WeChat.app、不重新扫码登录。

📨

纯后台发消息,不碰 UI

send 零闪、不抢焦点、不模拟点击。让微信自己的发送函数在真进程里跑,只改内存里的收件人和内容。

📖

读会话·历史·图片

sessions / history / search / image get / audio transcribe —— 群名、图片、语音转写一把梭,默认 YAML,--json 喂给 agent。

🔌

gRPC · HTTP · Wechaty 集成

本地 HTTP/SSE 桥、Wechaty Puppet gRPC gateway、versioned REST /v1,一套 daemon 撑三个面。n8n / Dify / LangChain 零适配接入。

为什么不用……

不用 iPad 协议 bot

那类方案是「再造一个会说微信协议的客户端」,天然带可被风控识别的协议指纹和异常登录设备。wechat-use 没有可被识别的客户端 —— 被驱动的正是你本机那台已登录设备上的正版微信。服务端看到的,就是官方客户端用官方 LongLink 通道发的、版本完全自洽的流量。

不用网页版

网页版早已大面积关停、功能残缺,且是独立登录态。wechat-use 直接读你桌面客户端的本地库(从真进程取出的真 key 解密),会话、历史、图片、语音全在,不受网页版限制。

不用 UI 自动化

AppleScript keystroke 要 activate、会闪;AX 对微信 Qt 窗口不可见。wechat-use 走 CGEventPostToPid 把按键直接投递进目标进程事件队列,再在微信自己的 slot_send 上装 auto-continue 断点改路由 —— 与谁在前台无关,零焦点闪。

✅ 提示

首次 send(每次微信重启后)会 delivery_verify_timeout:手动在微信里给 filehelper 打一条并回车,把发送管线预热一次,再重试即可。发送需要给终端授「辅助功能」权限,wechat-use doctor 会帮你弹出设置面板。

三步上手

⬇️