微信随手记 (WeChat Diary)

对着微信说话, 内容自动落进你自己电脑的 Obsidian 库。

扫码绑定一次微信 bot, 之后在手机上给它发文字、语音、图片, 只要电脑上的 Obsidian 开着, 每条消息都会追加到库里的 日记/YYYY/YYYY-MM-DD.md(路径可改, 也可以写进你已有的每日笔记)。纯 Markdown, 全部在你自己的机器上。

日记、备忘录、灵感、给爸妈记的病历, 发出去就记下了。

功能

• 发什么记什么: 不用任何开场白, 发出去就记下了。「撤回」删掉最后一条; 睡前说「晚安」(或「结束」「今天就到这」, 带语气词的「好，结束」「嗯 撤回」也听得懂)给今天收个尾, 不说也会跨天自动收尾; 「记：xx」把会被当成命令的词原样记下; 「帮助」看全部用法。

  

• 「在吗」只回状态, 不入库: 打招呼、探活这类消息不会记进笔记, bot 会告诉你它在、今天已记几段。

• 语音: 微信自动转写成文字, 带 🎤 标记入库; 转写失败时原始音频存进附件(SILK 格式, 播放可能需要转换), 想要文字版再说一遍就行。默认同时保存语音原声: 笔记里是微信样式的语音条(点击即播)+转写文字, 存为标准 WAV(约 3MB/分钟, 计入库体积); 不想要的在设置里关掉「保存语音原声」。

  

• 图片、文件、视频都收: 自动存进 日记/attachments/YYYY/ 并嵌入当天笔记, 文件保留原文件名, 单个上限 100MB(微信通道的限制)。「撤回」只删笔记里的引用, 附件保留。

• 公众号文章剪藏: 发 mp.weixin.qq.com 链接, 自动保存标题、正文和图片到 <日记文件夹>/剪藏/, 当天日记保留原句并加一行入口。默认关, 在设置里打开「自动提取公众号正文」后生效; 开了以后「保存正文图片」默认开, 「其他网站的链接也提取正文」默认关。只发网址不剪藏时用 记：https://…。细节见 docs/web-clipping.md。

• 路径和附件位置可改: 路径格式有三个预设, 也可自定义(写法同 Obsidian 每日笔记的日期格式, 固定的文件夹名放方括号, 如 [daily]/YYYY/MM/YYYY-MM-DD); 附件可放日记文件夹内、跟随 Obsidian 的附件设置或自定义文件夹。改了只影响之后的文件。

• 可以写进你已有的每日笔记: 打开开关后, 微信内容写到当天每日笔记末尾的 ## 微信随手记 一节(标题可改), 插件只动这一节; 当天笔记还没建时按你指定的模板建。可一键导入 Obsidian 每日笔记的文件夹、日期格式和模板。

• 熬夜不怕跨天: 凌晨 4 点前记的算前一天, 睡前的话属于"今晚"(开了「写进已有的每日笔记」后可在设置里改)。

• 每日提醒: 到点(默认 21:30)今天还没记, 就在微信上提醒一次; 记过了不打扰, 连续 3 天没记就先安静下来。可关。

• 纯机械记录, 不经过任何 AI: 原文直存, 一个字不改(唯一例外: 写进每日笔记时行首的 # 会转义成 \#, 免得变成标题截断这一节); 只追加, 历史段落永不改写, 写入格式是公开契约(docs/data-contract.md)。无作者服务器、无账号、无遥测。

赞助

如果插件对你有用, 可以用微信扫描下方二维码打赏, 赞助作者一点 token, 谢谢！

安装与绑定

前提: 你的微信账号能用微信官方的 ClawBot 插件(入口: 微信 → 我 → 设置 → 插件 → ClawBot)。腾讯自 2026-03 起逐步放量, 几条要点:

• 手机微信需 8.0.70 以上。
• 插件页显示「暂无可用的插件」不等于不能用: 灰度只影响入口可见性, 直接扫本插件设置页里的二维码试即可(腾讯云官方 FAQ 明确说明)。
• 大陆手机号注册的微信号基本都能绑; 海外手机号注册的 WeChat 账号除少数地区(腾讯云 FAQ 只列了香港)外暂不支持, 扫码后提示"此账号暂时不支持该功能"。这是腾讯侧的账号地区限制, 与你人在哪里无关, 插件无能为力, 见 Tencent/openclaw-weixin#122。

1. 在 Obsidian 第三方插件里安装并启用(仅桌面端)。
2. 打开插件设置 → 扫码绑定 → 用手机微信扫码并确认。
3. 选好日记文件夹(默认 日记), 给 bot 发条消息试试。

限制

• 仅桌面端, 且只在 Obsidian 开着时工作。 关机、睡眠期间发的消息不丢, 下次打开会自动补记(24 小时内实测可补收, 更长未测)。
• 提醒是尽力而为: 只在电脑开着 Obsidian 时发得出; 微信对 bot 主动发消息的规则未公开, 偶尔可能发不出。要 100% 可靠, 请在手机日历里加一条日程。
• 转发走不通: 微信的转发列表里选不到 bot, 聊天记录、文件、公众号文章请在与 bot 的对话框里直接发。这是腾讯侧的限制。另: 重复发同一个文件偶尔会加密出错, 改个文件名再发即可。
• 写进已有的每日笔记时要知道的: ## 微信随手记 这一节归插件, 节从这个标题开始, 到下一个任意级别的标题或文件末尾结束, 节里你手写的内容也会被算进段数、可能被「撤回」删掉; 节后要写别的, 先起一个标题; 节标题别和你笔记里已有的标题重名。插件默认凌晨 4 点切天, 每日笔记按零点切, 想一致就把「一天从几点开始」设为 0。你正在编辑这个文件时插件也会写入, 只改自己那一节, 如遇内容错位请反馈。装了 Templater「新建文件时触发」的, 刚写入的内容可能被它覆盖, 插件会在 1.5 秒后复核补回(这期间「撤回」过的不补)。同一个文件手机上也在编辑时容易出同步冲突: Obsidian Sync 会自动合并; iCloud、坚果云这类同步盘出「冲突副本」时, 那天的微信内容可能留在副本里, 要你自己合并。

网络访问说明

本插件只与以下远程服务通信:

1. 腾讯 iLink bot 接口(ilinkai.weixin.qq.com 及登录后服务端指派的地址; 登录二维码页面也由腾讯域名提供): 扫码登录、拉取你发给 bot 的消息、回发回执。这是微信官方的 bot 通道, 你的消息本来就经过腾讯的基础设施。该连接直连不走系统代理, 因为端点拒绝代理 TLS。
2. 你主动发给 bot 的公众号页面及其正文图片: 剪藏默认关闭, 不访问任何网页。打开「自动提取公众号正文」后, 只请求消息里的 mp.weixin.qq.com 页面; 「保存正文图片」(默认开)会请求正文图片地址(可能位于第三方 CDN); 其他网站只有再打开「其他网站的链接也提取正文」后才会访问。三个开关都在设置里。插件不执行网页脚本, 不加载广告、iframe、样式等子资源, 拒绝本机、局域网和私有地址。
3. 你自己配置的 OpenAI 兼容接口: 当前版本未启用, 即使配置了也不会发出任何请求, 设置项为将来的可选功能保留。

除此之外没有任何网络请求, 无遥测、无统计、无作者运营的服务器。bot 绑定凭据与 AI Key 存放在 Obsidian 的密钥存储中(库文件夹之外, 同步工具不会带走); 同步进度、最近剪藏 URL 等非敏感状态存于插件的 data.json。

数据格式

默认布局:

日记/
├── 2026/
│   └── 2026-08-12.md
├── attachments/
│   └── 2026/
│       └── 2026-08-12-2305-a3f1.jpg
└── 剪藏/
    ├── 2026/
    │   └── 2026-08-28-文章标题-a1b2c3d4e5.md
    └── assets/2026/2026-08-28-a1b2c3d4e5/01-图片内容哈希.png

一天的文件长这样:

---
date: 2026-08-12
weekday: 周三
source: wechat-diary
---

# 2026-08-12

**23:05**

今天试了新的手冲豆子, 花香很明显。

![[日记/attachments/2026/2026-08-12-2305-a3f1.jpg]]

开了「写进已有的每日笔记」后, 文件是你自己的每日笔记, 插件只写 ## 微信随手记 一节, 节里的段头、块、封存行和上面一样。完整规则(只追加、时间戳按北京时间且时区可配、一次发送 = 一个 \n\n 分隔块、凌晨 4 点切天、共用模式下节的规则)见 docs/data-contract.md, 剪藏格式见 docs/web-clipping.md。

前身 Python 版 wechat-diary 已归档(2026-08), 它写出的库遵循同一契约, 本插件可直接接着写。

License

本项目采用 双许可(dual licensing) 模式, 版权归作者 ArtemisLin 所有:

• 开源许可: GNU AGPL-3.0。你可以自由使用、修改、再分发, 但任何基于本项目的衍生作品——包括魔改版插件, 也包括把它改造成通过网络提供的服务——在分发或对外提供服务时, 必须以同样的 AGPL-3.0 协议公开完整源码。
• 商业许可。如果你想在闭源产品中使用本项目、或者不便遵守 AGPL 的义务, 请通过 GitHub Issues 联系作者获取商业授权。

说明:

• v0.3.0 及之前的版本是按 MIT 协议发布的, 该授权对已获取的副本继续有效; 自 2026-08-18 起仓库中的代码及之后的所有版本改按上述条款授权。
• 内嵌的 qrcode-generator 库版权归 Kazuhiko Arase, 保持其原有 MIT 授权。
• 向本项目提交代码(PR)即表示你同意: 你的贡献以 AGPL-3.0 授权, 同时授予作者将其一并纳入商业许可版本的权利——否则双许可无法维持。