v0.4.8

本版更新

• 客户端信息对齐官方 OpenClaw 微信插件 2.4.10（channel_version、iLink-App-ClientVersion，请求附带 bot_agent）。

扫码后微信提示「此 OpenClaw 的运行环境存在风险，暂无法连接」时：这是微信侧风控，短时间内多次扫码登录、机房 IP 都可能触发。请先停止尝试，隔几个小时（最好第二天）再试一次，准备好再生成二维码、生成后立即扫。

如何升级

配置、登录状态、收件箱都兼容，不需要重新扫码；正在运行的 wx-bot 服务会自动重启。

你现在的版本	升级命令
v0.4.0 及以后	wx-bot update
任何版本（包括 Go 版 v0.3.x）	curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
Docker（如 Pi Durable）	镜像改为 ghcr.io/lawrencewzen/wx-bot:0.4.8，然后 docker compose up -d

让 Agent 升级：对 Grok Bot / Muse 说「帮我把 wx-bot 升级到最新版」，它会按 升级说明 执行。

升级后用 wx-bot version 确认版本为 v0.4.8。需要回滚：wx-bot update --version <旧版本>。

---

What's Changed

• 客户端信息对齐官方插件 2.4.10 by @lawrencewzen in #11

Full Changelog: v0.4.7...v0.4.8

v0.4.7

本版更新

• 新增 wx-bot uninstall：wx-bot uninstall 列出会删除的内容，--yes 执行，--keep-data 保留登录状态（重装不用扫码）。会停掉服务、删除配置、状态、日志、二维码图片和程序，并把被旧版改成 700 的 ~/workspace 改回 755。让 Agent 卸载时，它会按 卸载说明 同时删掉 hook / routine。
• 修复重装后二维码一直「过期」：二维码图片文件名带上二维码 id（如 wx-bot-qr-1-5bbf0bb1.png），不会再和上次登录留下的图片同名，被聊天界面缓存成旧码。

如何升级

配置、登录状态、收件箱都兼容，不需要重新扫码；正在运行的 wx-bot 服务会自动重启。

你现在的版本	升级命令
v0.4.0 及以后	wx-bot update
任何版本（包括 Go 版 v0.3.x）	curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
Docker（如 Pi Durable）	镜像改为 ghcr.io/lawrencewzen/wx-bot:0.4.7，然后 docker compose up -d

让 Agent 升级：对 Grok Bot / Muse 说「帮我把 wx-bot 升级到最新版」，它会按 升级说明 执行。

升级后用 wx-bot version 确认版本为 v0.4.7。需要回滚：wx-bot update --version <旧版本>。

---

What's Changed

• 二维码文件名带 id；新增 wx-bot uninstall by @lawrencewzen in #10

Full Changelog: v0.4.6...v0.4.7

v0.4.6

本版更新

• wx-bot update 现在会同时安装或更新保活脚本 wx-bot-keepalive（随发布一起提供、校验 sha256）。以后保活脚本有改动，升级程序时就一并拿到。

如何升级

配置、登录状态、收件箱都兼容，不需要重新扫码；正在运行的 wx-bot 服务会自动重启。

你现在的版本	升级命令
v0.4.0 及以后	wx-bot update
任何版本（包括 Go 版 v0.3.x）	curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
Docker（如 Pi Durable）	镜像改为 ghcr.io/lawrencewzen/wx-bot:0.4.6，然后 docker compose up -d

让 Agent 升级：对 Grok Bot / Muse 说「帮我把 wx-bot 升级到最新版」，它会按 升级说明 执行。

升级后用 wx-bot version 确认版本为 v0.4.6。需要回滚：wx-bot update --version <旧版本>。

---

What's Changed

• wx-bot update 同时更新保活脚本 by @lawrencewzen in #9

Full Changelog: v0.4.5...v0.4.6

v0.4.5

本版更新：重启后自动恢复

• 保活脚本 wx-bot-keepalive：install.sh 会一起安装。wx-bot 没在运行就用保存的登录状态重新拉起（不用重新扫码），程序丢失会自动重装；只有登录过期、代理失效这类修不好的问题才输出 NEED_USER。适合没有 systemd 的云电脑（如 Grok Bot）。
• Grok Bot：安装时多建一个每 10 分钟运行的「wx-bot 保活」routine，云电脑重启后最多约 10 分钟自动恢复。
• 开机自启：Linux 上 install.sh --service 会开启 loginctl enable-linger；Muse 的系统服务 enable 后本来就随开机启动。
• 安装说明拆分：AGENTS.md 只保留识别表和通用规则，各 Agent 的步骤移到 docs/agents/。

程序本身与 v0.4.4 相同，主要是安装脚本和说明的更新。已经装好的 Grok Bot：对它说「帮我把 wx-bot 升级到最新版」，它会按 升级说明 补上保活 routine。

如何升级

配置、登录状态、收件箱都兼容，不需要重新扫码；正在运行的 wx-bot 服务会自动重启。

你现在的版本	升级命令
v0.4.0 及以后	wx-bot update
任何版本（包括 Go 版 v0.3.x）	curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
Docker（如 Pi Durable）	镜像改为 ghcr.io/lawrencewzen/wx-bot:0.4.5，然后 docker compose up -d

让 Agent 升级：对 Grok Bot / Muse 说「帮我把 wx-bot 升级到最新版」，它会按 升级说明 执行。

升级后用 wx-bot version 确认版本为 v0.4.5。需要回滚：wx-bot update --version <旧版本>。

---

What's Changed

• 开机自启与保活：linger + wx-bot-keepalive + Grok 保活 routine by @lawrencewzen in #7
• 修复保活脚本：加载 env，避免误杀正常运行的 wx-bot by @lawrencewzen in #8

Full Changelog: v0.4.4...v0.4.5

v0.4.4

本版更新：双向异常通知

• wx-bot 出问题 → 告诉 Agent：连不上微信超过 2 分钟、微信登录过期、断线恢复时，wx-bot 通过原有投递通道（webhook / pull）发一条 kind: "alert" 事件，Agent 在它自己的聊天里告诉你。Grok、Muse、Pi 通用。
• Agent 出问题 → 用微信告诉你：排队的消息超过 10 分钟没人处理（webhook 一直失败、pull 没人取），wx-bot 直接给你的微信发提醒，恢复后再发一条。
• wx-bot health --liveness：只检查服务是否在运行；Muse hook 改用它。

升级后请让 Agent 更新指令（对它说「帮我把 wx-bot 升级到最新版」即可，它会按 AGENTS.md 做）：Grok 更新 routine 指令，Muse 更新唤醒指令和 hook。没更新的 Agent 会忽略 alert 事件，不会出错。

Pi Durable：alert 事件的 from_wxid、message_id 为空，请用 event_id 做幂等键，详见 docs/integrations/pi-durable.md。

如何升级

配置、登录状态、收件箱都兼容，不需要重新扫码；正在运行的 wx-bot 服务会自动重启。

你现在的版本	升级命令
v0.4.0 及以后	wx-bot update
任何版本（包括 Go 版 v0.3.x）	curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
Docker（如 Pi Durable）	镜像改为 ghcr.io/lawrencewzen/wx-bot:0.4.4，然后 docker compose up -d

让 Agent 升级：对 Grok Bot / Muse 说「帮我把 wx-bot 升级到最新版」，它会按 AGENTS.md 执行。

升级后用 wx-bot version 确认版本为 v0.4.4。需要回滚：wx-bot update --version <旧版本>。

---

What's Changed

• 双向异常通知：alert 事件 + Agent 不响应时微信提醒 by @lawrencewzen in #6

Full Changelog: v0.4.3...v0.4.4

v0.4.3

本版更新

• 修复：wx-bot login --qr-png 写出的二维码图片为 0600，且会把所在目录改成 0700，导致 Agent 聊天界面「找不到图片」。现在图片为 0644，不再修改目录权限。

如果你的 Agent 在 v0.4.1 / v0.4.2 下把二维码写进了它的工作目录（如 Muse 的 ~/workspace），请把该目录权限改回原值（通常 chmod 755 ~/workspace）。

如何升级

配置、登录状态、收件箱都兼容，不需要重新扫码；正在运行的 wx-bot 服务会自动重启。

你现在的版本	升级命令
v0.4.0 及以后	wx-bot update
任何版本（包括 Go 版 v0.3.x）	curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
Docker（如 Pi Durable）	镜像改为 ghcr.io/lawrencewzen/wx-bot:0.4.3，然后 docker compose up -d

让 Agent 升级：对 Grok Bot / Muse 说「帮我把 wx-bot 升级到最新版」，它会按 AGENTS.md 执行。

升级后用 wx-bot version 确认版本为 v0.4.3。需要回滚：wx-bot update --version <旧版本>。

---

What's Changed

• 修复：二维码 PNG 权限导致聊天界面找不到图片 by @lawrencewzen in #5

Full Changelog: v0.4.2...v0.4.3

v0.4.2

本版更新

修复 Agent 发出的登录二维码总是「已过期」或显示 Not found：

• 二维码约 2 分钟过期。wx-bot login 新增 --timeout（默认 10 分钟），期间每张过期就换新码，不再只换 3 次。
• --qr-png 每张码单独一个文件（qr-1.png、qr-2.png……）。之前复用同一路径，聊天里按路径显示的图片会变成后来的码或 Not found。登录结束后图片自动删除，避免误发旧码。
• 日志为每张码标出编号和过期时间（UTC）。

Muse 用户：升级后重新扫码时，Muse 会按新的 AGENTS.md 第 3 步发码。

如何升级

配置、登录状态、收件箱都兼容，不需要重新扫码；正在运行的 wx-bot 服务会自动重启。

你现在的版本	升级命令
v0.4.0 及以后	wx-bot update
任何版本（包括 Go 版 v0.3.x）	curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
Docker（如 Pi Durable）	镜像改为 ghcr.io/lawrencewzen/wx-bot:0.4.2，然后 docker compose up -d

让 Agent 升级：对 Grok Bot / Muse 说「帮我把 wx-bot 升级到最新版」，它会按 AGENTS.md 执行。

升级后用 wx-bot version 确认版本为 v0.4.2。需要回滚：wx-bot update --version <旧版本>。

---

What's Changed

• 修复扫码登录：二维码过期、旧图误发、Not found by @lawrencewzen in #4

Full Changelog: v0.4.1...v0.4.2

v0.4.1

本版更新

• 断线不再静默：wx-bot status 新增 poll: 行；新命令 wx-bot health 在连不上微信时退出码为 1，并说明原因和处理办法（服务没带代理、代理变了、登录过期、服务没运行）。
• 服务自动带上代理：Linux 上 install.sh 会把 shell 里的 https_proxy 等变量写入 ~/.config/wx-bot/env。云电脑只能经代理出网时，之前的服务会一直连不上。
• Muse hook 异常唤醒：hook 检测到 wx-bot 异常时会唤醒 Muse，让它告诉你原因；推荐间隔改为 5 秒。

Muse 用户：升级后请让 Muse 按 AGENTS.md 第 5 步更新 hook 脚本，否则断线时仍不会提醒。

如何升级

配置、登录状态、收件箱都兼容，不需要重新扫码；正在运行的 wx-bot 服务会自动重启。

你现在的版本	升级命令
v0.4.0 及以后	wx-bot update
任何版本（包括 Go 版 v0.3.x）	curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
Docker（如 Pi Durable）	镜像改为 ghcr.io/lawrencewzen/wx-bot:0.4.1，然后 docker compose up -d

让 Agent 升级：对 Grok Bot / Muse 说「帮我把 wx-bot 升级到最新版」，它会按 AGENTS.md 执行。

升级后用 wx-bot version 确认版本为 v0.4.1。需要回滚：wx-bot update --version <旧版本>。

---

What's Changed

• 连接健康检查：断线不再静默，服务自动带上代理 by @lawrencewzen in #3

Full Changelog: v0.4.0...v0.4.1

v0.4.0

如何升级

配置、登录状态、收件箱都兼容，不需要重新扫码；正在运行的 wx-bot 服务会自动重启。

你现在的版本	升级命令
v0.4.0 及以后	wx-bot update
任何版本（包括 Go 版 v0.3.x）	curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
Docker（如 Pi Durable）	镜像改为 ghcr.io/lawrencewzen/wx-bot:0.4.0，然后 docker compose up -d

让 Agent 升级：对 Grok Bot / Muse 说「帮我把 wx-bot 升级到最新版」，它会按 AGENTS.md 执行。

升级后用 wx-bot version 确认版本为 v0.4.0。需要回滚：wx-bot update --version <旧版本>。

---

What's Changed

• ci: Actions 升级到 Node 24 版本，固定 ubuntu-24.04，CI 增加镜像构建检查 by @lawrencewzen in #1
• 用 TypeScript 重写：core / cli / cloudflare 三层 by @lawrencewzen in #2

New Contributors

• @lawrencewzen made their first contribution in #1

Full Changelog: v0.3.0...v0.4.0

v0.3.0

Full Changelog: v0.2.0...v0.3.0