让 AI 助理“看懂”你的微信聊天记录，数据全程留在本地

你可能遇到过这种情况：想搜索半年前某条重要的微信消息，翻遍聊天记录却怎么也找不到。或者想分析一下某个群聊的活跃度，却只能靠人工数数。微信群消息每天上万条，重要讨论被灌水淹没，退群怕错过信息，不退又刷不过来。

现在，一个名为 wechat-cli 的开源工具完美解决了这个问题。它让你在终端里直接查询本地微信的所有数据，专为 AI Agent 设计，数据永不离开本机。

今天，我就带大家全面了解 wechat-cli 的功能，以及如何将它接入 OpenClaw 和 WorkBuddy 两大主流 AI Agent 框架。

一、wechat-cli 是什么？

简单来说，wechat-cli 是一个微信的命令行工具，让你通过命令操作本地微信数据。全程本地运行，不走任何第三方服务器，零封号风险。更重要的是，它的设计初衷就是给 AI Agent 用的——所有输出默认 JSON 格式。

项目已完全开源，GitHub 地址：https://github.com/huohuoer/wechat-cli

核心功能

wechat-cli 提供了 11 个命令，覆盖日常高频场景：

命令

功能

init

一键初始化，提取密钥

sessions

列出最近会话

history

查看聊天记录，支持分页和时间过滤

search

全局搜索消息

contacts

搜索联系人、查看详情

members

列出群成员

stats

聊天统计：谁最活跃、消息类型分布、24小时活跃图

export

导出聊天记录为 Markdown 或纯文本

favorites

查看微信收藏

unread

查看未读会话

new-messages

增量获取新消息

实际使用示例

# 查看最近20条聊天会话wechat-cli sessions --liMIT 20# 读取与某人的聊天记录wechat-cli history "张三" --limit 50# 在指定群中搜索关键词wechat-cli search "项目deadline" --chat "团队群"# 查看未读消息wechat-cli unread# 获取新消息wechat-cli new-messages# 统计群聊活跃度wechat-cli stats "团队群" --format text

返回结果包括：总消息数、各类型消息占比、发送者排名、24小时活跃分布等丰富数据。

二、OpenClaw 接入 wechat-cli 部署指南

OpenClaw（业内俗称“小龙虾”）是奥地利开发者 Peter Steinberger 于 2025 年 11 月发布的开源个人 AI 助手，采用 MIT 开源协议，定位为“真正能执行任务的 AI”。它具备系统级执行能力，可实现从意图理解到任务拆解、执行闭环再到结果反馈的全流程自动化。

安装 wechat-cli

在 OpenClaw 环境中，直接发送以下命令让 AI 自动安装：

帮我配置并安装：npm install -g @canghe_ai/wechat-cli

AI 会自动完成 wechat-cli 的安装和初始化配置。

第五步：使用验证

安装完成后，你就可以在微信中直接给 OpenClaw 发送指令了，比如：

“帮我看看微信有没有未读消息？”“总结一下技术群今天的讨论精华。”“统计一下这周团队群里谁发言最多？”

AI 会自动调用 wechat-cli 读取本地数据并返回结果。

三、WorkBuddy 接入 wechat-cli 部署指南

WorkBuddy 是腾讯推出的 AI 原生桌面智能体工作台，可直接操控本地电脑，自动规划与执行多步骤任务。它兼容 OpenClaw 技能生态，内置多种 Skills 技能包与 MCP 协议，开箱即用。

安装 wechat-cli

在 WorkBuddy 的工作环境中安装 wechat-cli：

npm install -g @canghe_ai/wechat-clisudo wechat-cli init

确保微信正在运行，初始化过程会自动提取数据密钥。

第三步：配置微信 ClawBot 接入打开 WorkBuddy，点击左下角头像 → Claw 设置 → 集成（BETA）找到“微信 ClawBot 集成”，点击“配置”页面出现二维码，用手机微信扫码确认等待状态变为“已绑定”✅第四步：开始使用

配置完成后，在微信联系人中找到 ClawBot 的账号，直接发送消息即可调用 wechat-cli 的能力。你可以问它：

“帮我搜索一下昨天团队群里关于‘上线’的消息”“统计一下产品群本月最活跃的前 5 个人”“检查一下有没有未读的重要消息”

AI 会自动调用 wechat-cli 查询本地数据并回复。

四、实用案例案例一：团队群聊日报自动生成

场景：你是项目负责人，每天需要了解团队群的核心讨论内容。

操作：在微信中向 ClawBot 发送指令：

“帮我统计一下‘研发团队群’今天的消息情况，总结精华内容”

AI 会自动执行以下步骤：

调用 wechat-cli history "研发团队群" --limit 200 获取今日消息调用 wechat-cli stats "研发团队群" --format json 获取活跃统计对消息进行智能分析和摘要返回一份完整的日报：包含今日消息总数、发言人数、最活跃成员、核心讨论话题、关键决策和待跟进事项案例二：群聊发言排行与活跃度分析

场景：运营人员需要了解某个用户群的活跃成员，以便定向运营。

操作：在 AI Agent 中发送：

“分析一下‘产品内测用户群’近 7 天的发言情况，给出发言排名”

AI 会调用 wechat-cli stats "产品内测用户群" 命令，返回：

总消息数及各类型消息占比（文字、图片、语音等）发送者排名（谁是话痨、谁在潜水）24 小时活跃分布图（哪个时间段讨论最热烈）

这些数据可以帮助你精准识别活跃用户，制定更有针对性的运营策略。

五、安全说明

wechat-cli 的设计核心是数据安全：

所有数据解密都在本地完成，数据永远不会离开你的电脑macOS 上首次初始化需要 sudo 权限来读取微信的加密密钥如果遇到权限问题，工具会自动尝试重新签名微信应用，按提示操作即可本项目仅限个人学习使用，遵循 Apache License 2.0 开源协议，不得滥用于非法用途

#龙虾##openclaw##微信##腾讯#