Agent WeChat：开源微信客户端与代理接入

项目简介

Agent WeChat 是一个开源的微信客户端，面向普通用户和 AI 代理。它直接与微信通信，守护进程（daemon）运行时不依赖官方客户端同时开启。同一套能力可用于替代桌面客户端、终端 wx 命令行以及 AI 代理接入。核心守护进程用 Rust 编写，负责账号、同步与媒体处理；桌面端、CLI 和 OpenClaw 插件共享同一个带鉴权的 HTTP API 与事件流，你也可以用自己的脚本和客户端调用这套 API。

主要功能

• 会话：私聊与群聊、本地历史浏览与搜索、未读数查看与标记已读。
• 消息：收发文本、图片、视频、文件和语音；可撤回自己符合条件的消息，并显示收到的撤回。
• 图片与视频：预览、下载不同清晰度版本（含原图/原视频），发送普通或原画质视频。
• 语音：播放收到的语音，并以原生语音条发送；较长音频可能被拆成多条。
• 富内容：读取引用、链接卡片元数据与转发的聊天记录。
• 表情：获取受支持的普通/共享表情，包括动图原图；不支持发送表情与管理表情包。
• @ 提及：发送真实成员提及或 @所有人，查看收到的提及信息。
• 联系人与群：查找联系人/群、读取成员列表与头像；建群、改名、退群、增删成员、设置群昵称、清除公告、群消息免打扰等群管理操作。
• 整理：置顶/取消置顶受支持的会话，对普通联系人和群开启或关闭免打扰。
• 媒体存储：按账号配置自动下载、保存已校验媒体、查看传输进度与不可用媒体状态。
• 桌面端：会话搜索、媒体视图、引用跳转、提及选择器、原生文件保存、托盘行为与通知。
• 自动化：通过 wx CLI 或带鉴权的 HTTP API 操作，跟随可重放事件，查看发送与下载任务。

安装与使用

桌面应用：从 GitHub Releases 下载对应平台的安装包，选择「Use this device」运行本地 hub，或选择「Connect to another hub」，然后添加微信账号并按手机端提示登录。应用内包含聊天界面、原生 hub 和 wx CLI。

终端与 API：

npm install -g @agent-wechat/cli
wx --json version
wx serve

需要允许该包的安装脚本执行，以便下载并校验原生可执行文件；此外也支持 pnpm、独立二进制和 Docker 等安装方式。语音/视频处理需要在守护进程主机上安装 FFmpeg 与 FFprobe，桌面版已内置。

若已有受支持的 WeChat for Linux 配置，可先关闭官方客户端并备份文件，然后：

wx auth login --official
wx accounts list
wx chats list

查看会话并保存附件：

wx contacts find Alice
wx messages list CHAT_ID --limit 20
wx messages media CHAT_ID MESSAGE_ID --output ./saved-image.jpg

接入 AI 代理（OpenClaw）：

openclaw plugins install @agent-wechat/agent-wechat

随后按 OpenClaw 的配置文档选择账号、创建作用域 token，并设定代理可以应答的对象。私聊与群聊在完成配置前默认关闭；回复会使用所连接的账号发出。

注意事项

• 复用官方微信配置时，守护进程运行期间需保持官方客户端关闭，同一配置只能有一个写入者。
• 新建的配置不会包含完整的旧聊天记录；搜索只覆盖本地保存的历史，而非全部远端历史。
• 桌面打包与真机验收情况因平台而异，使用前请查看仓库中的 PLATFORM-ACCEPTANCE.md 和对应版本的发布说明。
• 带引用回复、链接卡片发送等能力已实现，但仍待真实接收方验证；媒体是否可用取决于来源、格式与大小限制。
• 归档类代理工具会放开账号范围的读取权限，只应授予需要该权限的代理。
• 已有配置的兼容性针对可识别的 Linux 目录结构，未知文件会被保留，不支持的数据库结构会被拒绝。

本作品整理自 GitHub 开源项目 thisnick/agent-wechat，原作者 @thisnick，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。