微信机器人使用文档

Appearance

更新日志 ​

[5.1.0] - 2026/05/16 ​

体验性优化 ​

  • iPad 协议新增支持 pprof 监控(查看方法: 机器人详情界面，更新镜像下拉框 -> 性能采样)

[5.0.0] - 2026/05/16 ​

体验性优化 ​

  • 重构了长期记忆模块

  • 优化了 GitHub Actions 的构建速度

  • 群聊总结新增图片模式

  • 修复引用抖音链接也会触发抖音解析的问题，抖音视频下载增加了大小限制，超过 25M 的视频不会下载

  • 优化 Qdrant 向量数据库 Docker-compose 配置

  • 移除了一些废弃的数据表

  • 处理历史消息的时候，超过 10 分钟的历史消息不会处理，避免扫码登录且勾选了同步历史消息的时候引起不必要的刷屏

  • 同步群成员新增群成员的性别信息，群成员的性别信息会注入 AI 上下文

[4.7.0] - 2026/05/01 ​

体验性优化 ​

  • OpenAI SDK 迁移到官方版

  • 同步朋友圈时间间隔，以前硬编码 10 分钟，现在支持界面设置

新功能 ​

  • 重构了记忆模块

[4.6.0] - 2026/04/19 ​

BUG 修复 ​

  • 优化艾特处理逻辑

  • 优化语言发送接口失真问题

体验性优化 ​

  • 去除返回的思考内容<think /> 和 <thinking />标签包裹的内容

  • 支持修改文本嵌入维度，以前代码写死 1536，现在支持配置，以适配更多模型

新功能 ​

[4.5.0] - 2026/04/10 ​

BUG 修复 ​

  • 修复解析引用消息可能会类型解析错误的问题

  • 暂时移除长期记忆功能，待重构后上线

体验性优化 ​

  • 优化 skill 执行流程

新功能 ​

  • 内置检索知识库文档工具

[4.4.0] - 2026/04/05 ​

体验性优化 ​

  • 重写了记忆模块

[4.3.1] - 2026/04/04 ​

体验性优化 ​

  • Skills 安装源支持 Gitea

  • 去除 AI 返回的 思维链内容

[4.3.0] - 2026/04/04 ​

新功能 ​

  • OSS 支持火山云

体验性优化 ​

  • 优化抖音解析背景音乐发送效果

[4.2.0] - 2026/03/29 ​

新功能 ​

  • 优化聊天记录搜索功能

[4.1.0] - 2026/03/21 ​

新功能 ​

  • AI 长久记忆新增开关

[4.0.0] - 2026/03/13 ​

新功能 ​

  • AI 对话支持长久记忆

[3.1.0] - 2026/03/12 ​

破坏性更新 ​

新功能 ​

  • Agent Skills 引擎注入机器人上下文环境变量
ROBOT_WECHAT_CLIENT_PORT: 机器人客户端服务端口，可用于在 SKILL 脚本直接调用客户端接口 `http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/xxxxx`
ROBOT_ID: 机器人实例 ID
ROBOT_CODE: 机器人实例编码
ROBOT_REDIS_DB: 机器人的 Redis DB
ROBOT_WX_ID: 机器人的微信 ID
ROBOT_FROM_WX_ID: 微信消息来源(群聊 ID 或者好友微信 ID)
ROBOT_SENDER_WX_ID: 微信消息发送人的微信 ID
ROBOT_MESSAGE_ID: 微信消息 ID
ROBOT_REF_MESSAGE_ID: 如果是引用消息，则是引用的消息的 ID

  • 支持注入自定义环境变量，可用于配置 SKILL 脚本的私密数据

  • 新暴露了支持发送本地文件的发送图片/视频/文件/语音的接口(用于 Skills)

Body 公共参数
{
  "to_wxid": "",
  "file_path": ""
}
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/robot/message/send/image/local
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/robot/message/send/video/local
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/robot/message/send/voice/local
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/robot/message/send/file/local

[3.0.0] - 2026/03/07 ​

破坏性更新 ​

  • 表结构更新，请按照 SQL 升级脚本进行升级

  • wechat-robot-admin-backend 服务需要新增一个环境变量：HOST_DATA_DIR: ${PWD} # 自动取 docker-compose.yml 所在目录的绝对路径，详情见 docker-compose.yml 文件

新功能 ​

  • 内置 Agent Skills 引擎

  • 新增群红包通知功能，支持通知指定的多个人

[2.6.0] - 2026/02/22 ​

破坏性更新 ​

  • docker-compose 文件新增本地部署网易云

网易云部署完后，记得访问 http://localhost:3000/qrlogin.html 登录

  • MCP 点歌工具采用本地访问本地部署服务，需要更新 MCP 工具版本

体验性优化 ​

  • 抖音解析支持发送图片 BGM

[2.5.0] - 2026/02/18 ​

破坏性更新 ​

新特性 ​

  • 新增群红包提醒功能

  • 新增 AI 播客功能(完善中...)

体验性优化 ​

  • 普通聊天去除 ai 参数 MaxCompletionTokens，支持思考的模型思维链会占用 token 数，导致 AI 无内容输出

  • AI 后端改为流式输出，以支持某些思考模型，流式输出完成后再将消息统一发送到微信。

  • 提升命令行 MCP 服务器的兼容性

[2.4.0] - 2026/02/01 ​

破坏性更新 ​

  • 表结构更新，请按照 SQL 升级脚本进行升级

  • AI 绘图配置数据结构有变化，请重新配置

体验性优化 ​

  • 支持解析抖音图片

  • AI 绘图新增造相(Z-Image)

[2.3.0] - 2026/01/02 ​

破坏性更新 ​

体验性优化 ​

  • 群聊短视频解析支持开/关了

[2.2.0] - 2025/12/31 ​

破坏性更新 ​

新特性 ​

  • 新增表情包提取 MCP 工具

  • 新增群成员管理功能，将群成员设置为管理员 / 将群成员加入黑名单(黑名单的成员不会触发 AI 交互)

体验性优化 ​

  • 优化聊天记录查询性能

  • 优化 MCP 协议，新增 MCP 私有协议，用于发送聊天记录、图片、视频、语音等等

  • 优化群聊总结提示词，新增提取群聊分享的链接资源

  • Mac 自动过滑块改为手动过滑块，提升准确性

BUG 修复 ​

  • 修复引用消息丢失了部分上下文的问题

  • 修复群成员最后活跃时间不正确的问题

[2.1.0] - 2025/11/23 ​

体验性优化 ​

  • 图片 / 视频改成分片发送，解决发送大视频内存爆炸的问题

[2.0.0] - 2025/11/15 ​

破坏性更新 ​

  • wechat-robot-admin-backend服务新增了一个必填环境变量UUID_URL，可填写为http://wechat-slider:9000

  • 表结构新增和更新，请按照 SQL 升级脚本进行升级

  • 需要更新wechat-slider服务的镜像，执行 docker pull registry.cn-shenzhen.aliyuncs.com/houhou/wechat/wechat-slider-base:latest

  • 移除 jimeng-free-api 服务，执行 docker compose rm -s -f jimeng-free-api 或者 docker-compose rm -s -f jimeng-free-api，哪个能用用哪个

  • 拉取最新代码获取最新docker-compose.yml文件，根据文件内容，手动拉一遍镜像，成功率更高。

新特性 ​

  • 完整的 MCP 协议支持

  • 开放微信消息 Webhook 回调

体验性优化 ​

  • iPad 协议新增支持 pprof 监控(启用方法: 机器人详情界面，更新镜像下拉框 -> 删除服务端容器 -> 创建服务端容器 (启用pprof))

  • 即梦逆向 api 由 jimeng-free-api 迁移到 jimeng-api，以支持更多功能

  • 优化机器人管理后台前端项目本地Docker构建(本地构建使用 dev.Dockerfile)

BUG 修复 ​

  • 修复 iPad 协议提取 ticket 异常的问题

[1.6.0] - 2025/10/12 ​

体验性优化 ​

  • 提高抖音视频解析稳定性。(破坏性更新： 抖音解析的 API 由免费 API 改为收费 API，原先的环境变量THIRD_PARTY_API_KEY记得保持余额充足，一分钱解析10次。附：充值链接)

[1.5.2] - 2025/10/01 ​

新特性 ​

[1.5.1] - 2025/09/27 ​

体验性优化 ​

  • 支持登录设备迁移 (导出登录信息、导入登录信息)

[1.5.0] - 2025/09/27 ​

体验性优化 ​

  • 显示当前登录设备类型和微信版本。

[1.4.3] - 2025/09/22 ​

新特性 ​

  • iPad 伪装登录。

[1.4.2] - 2025/09/21 ​

BUG 修复 ​

  • 修复点歌接口挂了的问题

  • 修复发送AI消息获取音色接口挂了的问题

  • 修复扫码登录UUID检测异常的问题

[1.4.1] - 2025/09/21 ​

新特性 ​

  • Mac 扫码登录支持自动过滑块。

本次更新包含破坏性更新

wechat-robot-admin-backend服务需要新增两个环境变量，否则服务会启动失败

  • SLIDER_SERVER_BASE_URL=http://wechat-slider:9000
  • SLIDER_TOKEN=xxxxxxx # 滑块验证码服务密钥，请加入官方交流群获取

[1.4.0] - 2025/09/20 ​

新特性 ​

  • Mac 扫码登录支持手动过滑块。

本次更新包含破坏性更新

wechat-robot-admin-backend服务需要新增两个环境变量，否则服务会启动失败

[1.3.0] - 2025/09/19 ​

体验性优化 ​

  • 抖音视频会同时发送链接和视频。

BUG 修复 ​

  • 修复 Mac 登录异常的问题。

[1.2.0] - 2025/09/10 ​

体验性优化 ​

  • 抖音视频由手动出发改为自动触发。

[1.1.15] - 2025/09/09 ​

体验性优化 ​

  • 抖音视频解析由直接发送视频改为发送卡片链接。

[1.1.14] - 2025/09/06 ​

体验性优化 ​

  • 公众号如果没有手动开启AI聊天，默认不开启 (原来会继承全局 AI 设置)。

  • 群聊总结改为以聊天记录的形式发送，避免内容过多被折叠。

[1.1.13] - 2025/09/04 ​

BUG 修复 ​

  • 修复因为每日早报上游接口数据结构变化导致获取每日早报失败的问题

  • 修复AI机器人在私聊场景会响应自己发送(从其他设备发送)的消息的问题。

[1.1.12] - 2025/08/29 ​

新特性 ​

  • 支持通过登录密钥登录机器人管理后台

[1.1.11] - 2025/08/19 ​

新特性 ​

  • 支持多种登录方式(iPad、Windows微信、车载微信、Mac微信)

  • 支持Data62登录

  • 支持A16登录

修改 ​

  • 优化创建机器人docker容器流程，如果docker镜像还没拉取过，会自动拉取 (wechat-robot-admin-backend)

[1.1.10] - 2025/08/18 ​

新特性 ​

  • 新增文本消息群发接口

[1.1.9] - 2025/08/16 ​

新特性 ​

  • 支持发送文件消息，流式发送，避免发送超大文件时，内存溢出

微信机器人使用文档

Copyright © 2026