WeChatAgent

Linux 微信记忆与自动回复套件

把浏览器微信、聊天同步、长期记忆、AI 接话、技能系统、图片理解和可视化控制台打包成一套 Docker Compose 服务。

微信窗口 3000 · 控制台 8078 · AI 记忆 8090 · Docker Compose 一套部署

WeChatAgent 把 Linux 微信窗口、聊天同步、长期记忆、AI 接话、技能系统和可视化控制台打包成一套 Docker Compose 服务。目标是：在 NAS 或另一台电脑上登录微信后，直接拥有一个可观察、可配置、可扩展的微信群 Agent。

默认不会把模型密钥、微信数据库、登录数据、运行记忆上传到 GitHub 或镜像。新机器部署后需要自己登录微信并配置模型。

功能总览

模块	能力
浏览器微信	通过 wechat-selkies 在浏览器里操作 Linux 微信，默认端口 3000
聊天同步	只读解密微信数据库，增量同步消息、成员、媒体和会话状态
长期记忆	消息索引、事实库、人物画像、群摘要、知识图谱、关系视图
自动回复	评分阈值判断、@ 必回、群组自动切换、随机延迟、避免回复自己
技能系统	支持 SKILL.md、内置技能、OpenAPI/HTTP 技能、导入导出、权限开关、运行日志
内置技能	网络搜索、斗图发图、公众号标题识别、图片理解
群日报	基于真实聊天记录生成图文日报，可作为图片发送到群
图片记忆库	群图解析、标签入库、画廊展示、失败重试、按群导入导出
控制台	服务状态、模型配置、模式参数、回复实时状态、宇宙总览、排行榜
数据维护	按群导出/导入、全量备份、运行数据恢复

版本更新

每一个发布版本都必须写入 CHANGELOG.md。发布脚本会自动检查更新日志，缺少对应版本记录会拒绝发布镜像。

v0.4.2 接话稳定与人格蒸馏 2026-06-20	新增 新增独立“系统日志”菜单，支持分类、等级、关键词筛选和实时刷新，失败原因会按秒记录。 新增当前群 Top10 人格蒸馏库：人格卡、证据原话、手动切换、测试改写和 12 小时刷新入口。 新增单群独立接话策略：每个群可单独配置模式、阈值、斗图概率、切群延迟和发送延迟。 新增性格改写总开关，想要更快回复时可以关闭额外 LLM 改写链路。 优化 启用单群策略的群会自动进入自动回复扫描范围，不再依赖旧白名单是否完整。 微信切群使用短关键词：PT、值班、测试，其他群默认使用前两位搜索。 文本和图片发送都会重新打开并验证目标群，降低复用旧聊天窗口导致发错群的风险。 保留 v0.4.1 的按群排除接话成员功能，并接入新自动回复链路。 修复 修复多群自动回复只处理一个群、其他群无反应的问题。 修复从测试群切到其他群时可能把回复发到上一个群的风险。 修复群日报图片发送状态里引用未定义变量的问题。 修复微信同步读取 FTS 辅助库和 SQLite malformed 时导致同步不稳定的问题。
v0.4.1 接话排除名单增强 2026-06-19	新增 按群配置“排除接话成员”，被排除成员发言或 @ 机器人都会跳过。 排除成员支持群员搜索，可按群昵称、昵称、alias、member username 快速过滤。 新增“当前群已排除成员”标签列表，可直观看到被排除的人并一键移除。 优化 接话评分、候选扫描和最终发送执行三层统一遵守排除名单。 排除匹配同时参考 member username、alias、群昵称、备注、昵称和同步联系人信息。 编辑自动回复配置时，状态轮询不会再覆盖正在操作的排除名单表单。 修复 修复排除成员面板初次打开时可能一直显示“等待同步群聊列表”。 修复清空排除名单后旧配置键仍残留的问题。 修复搜索过滤后勾选成员时，隐藏的已排除成员可能被误删的问题。
v0.4.0 登录守护与记忆控制台增强 2026-06-19	新增 Clawbot 微信掉线通知、重复提醒、手动检查和登录确认守护。 微信窗口视觉状态检测：区分 login_required、login_pending 和真实聊天界面。 记忆库管理、按群导出/导入、照片库画廊、图片解析入库和失败重试流程。 图片理解 Skill 的模型配置、连通性测试和上传图片测试能力。 证据驱动人物画像重建、进度状态、画像标签和关系数据增强。 优化 总览宇宙、排行榜、等级视觉、不同分辨率下的布局自适应。 自动回复的群组路由、蓝色 @、忽略自己消息、斗图触发和实时状态展示。 群总结模板、昵称映射、记忆库检索和图片总结展示效果。 修复 修复微信掉线后被 sync_worker_fresh 误判为“已恢复在线”的问题。 修复登录页“我知道了”和“登录”自动点击坐标，并在手机确认前保持等待状态。 修复多个模式参数、Skill 参数保存后刷新回退的问题。
v0.3.1 多架构镜像发布 2026-06-18	更新内容 DockerHub 项目服务镜像发布为 linux/amd64 与 linux/arm64 多架构 manifest。 取消微信 GUI 服务默认 linux/arm64 平台锁定，x86 NAS 和 Intel/AMD 服务器可自动拉取对应架构。 更新 NAS、x86、ARM、Apple Silicon 部署说明。 发布脚本改为默认使用 docker buildx build --platform linux/amd64,linux/arm64 --push。 验证 确认 ghcr.io/nickrunning/wechat-selkies:0.0.12-minimal 同时支持 linux/amd64 和 linux/arm64。
v0.3.0 正式 Docker 部署包 2026-06-18	新增 生产部署向 Docker Compose 打包方案。 .env.example，避免把本地路径、密钥、运行数据写死进仓库。 DockerHub 镜像工作流、本地开发 compose override、NAS/新电脑部署文档。 账号目录检测、数据库 key 提取、运行数据备份、恢复、本地开发启动和镜像发布脚本。 调整 用 WECHAT_ACCOUNT_DIR_NAME 替代硬编码微信账号目录。 控制台自动按配置发现微信数据库路径。 增加 host.docker.internal 映射，方便容器访问宿主机模型服务。 安全 确认 .env、config/、runtime/、微信 key、私有数据库和备份包不会进入 Git 或镜像。
v0.2.0 自动自由接话 2026-06-15	新增 微信群自动自由接话 worker。 基于评分阈值的自动发送模式。 按群水位线，开启自动回复时不会翻旧账回复历史消息。 Outbox 记录评分、阈值、决策、触发原因和发送确认。 自动回复状态 API 与控制台配置：允许群、轮询间隔、随机延迟和模式参数。 调整 自动回复复用已验证的微信 UI 发送器：切群、粘贴、校验输入框、再发送。 微信窗口操作串行化，多个群的评分和扫描可以并行覆盖。 连续回复同一个群时复用当前聊天窗口，不重复搜索群名。
v0.1.0 手动微信发送闭环 2026-06-15	新增 控制台生成回复后，可以手动粘贴到微信或发送到微信。 自动切换目标群：支持 值班群 和 PT站看片狂魔小群。 短关键词搜索：值班群 搜索 值班，PT站看片狂魔小群 搜索 PT。 群切换和发送动作支持随机延迟。 回复 outbox 记录草稿和发送尝试。 修复 修复预览状态残留导致回复发到上一个群的问题。 修复完整群名搜索打开微信全局搜索页的问题。 修复小尺寸微信窗口识别、Selkies 剪贴板粘贴和输入框校验可靠性。

服务架构

flowchart LR
  A["wechat-selkies\n浏览器微信 3000"] --> B["微信本地数据\nconfig/"]
  B --> C["wechat-memory-sync\n只读解密与同步"]
  C --> D["runtime/memory\n消息与媒体库"]
  D --> E["wechat-ai-memory\n长期记忆 8090"]
  D --> F["wechat-agent-console\n控制台 8078"]
  E --> F
  F --> G["微信窗口自动化\n切群/粘贴/发送"]
  F --> H["LLM / 技能 / 图片理解"]

Loading

快速部署

1. 准备环境

需要一台已安装 Docker 和 Docker Compose 的机器。

当前发布镜像支持 linux/amd64 和 linux/arm64。x86 NAS、Intel/AMD Linux 服务器、ARM NAS、Apple Silicon 都使用同一套 Compose；默认会自动按宿主机架构拉取镜像。

git clone https://github.com/xiaoguiwucan/linux-wechat-agent.git
cd linux-wechat-agent
cp .env.example .env

完整部署需要 GitHub 仓库里的 docker-compose.yml、脚本和解密工具；DockerHub 镜像只承载项目服务程序。

默认端口只绑定本机 127.0.0.1。如果要让局域网访问，把 .env 里的这些值改成 0.0.0.0：

HTTP_BIND=0.0.0.0
AGENT_CONSOLE_BIND=0.0.0.0
AI_MEMORY_BIND=0.0.0.0

2. 启动微信窗口并登录

docker compose up -d wechat-selkies

打开：

• 微信窗口：http://127.0.0.1:3000

扫码登录微信，进入几个常用群，让微信把最近会话和数据库文件落到 config/。

3. 自动检测微信账号目录

./scripts/detect-wechat-account.sh

脚本会在 .env 写入：

WECHAT_ACCOUNT_DIR_NAME=wxid_xxx_xxxx

4. 提取数据库 key

保持微信窗口在线，然后运行：

./scripts/extract-wechat-keys.sh

成功后会生成：

runtime/wechat-decrypt/keys/all_keys.json
runtime/wechat-decrypt/config.json

5. 启动完整套件

docker compose up -d

打开控制台：

• Agent 控制台：http://127.0.0.1:8078
• AI 记忆 API：http://127.0.0.1:8090

进入控制台后，先在“模型”页面配置自己的 LLM。模型跑在宿主机时，容器里推荐填：

http://host.docker.internal:端口/v1

本地开发

发布部署默认拉 DockerHub 镜像。开发当前源码时使用 build 覆盖文件：

./scripts/dev-up.sh

或手动执行：

docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

常用命令

查看服务：

docker compose ps
docker compose logs -f wechat-agent-console

重启控制台：

docker compose restart wechat-agent-console

备份私有运行数据：

./scripts/backup.sh

恢复备份：

./scripts/restore.sh backups/wechat-agent-backup-YYYYMMDD-HHMMSS.tar.gz

升级镜像：

docker compose pull
docker compose up -d

发布到 DockerHub

先登录 DockerHub：

docker login

构建并推送：

./scripts/publish-dockerhub.sh docker.io/xiaoguiwucan/linux-wechat-agent 0.4.2

如果你的 DockerHub 用户名不同，把命令和 .env 里的 WECHAT_AGENT_IMAGE 改成你的镜像名。

数据与安全边界

这些内容不会进入 GitHub，也不会进入 Docker 镜像：

• .env
• config/ 微信登录与原始本地数据
• runtime/ 运行数据库、记忆库、密钥、媒体缓存
• all_keys*.json
• 模型 API Key、Tavily Key、图片理解模型 Key
• 备份包 backups/

请不要把备份包或运行目录公开上传。

更多文档

• NAS 部署指南
• 完整功能介绍
• DockerHub 发布说明
• GitHub Release 流程
• 本地开发记录