Merge pull request #129 from sliverp/fix/miss_to

docs: 添加 1.5.4 版本更新日志

README.md

@@ -413,5 +413,6 @@ openclaw gateway restart
 
 - [Rich Media Guide](docs/qqbot-media-guide.md) — images, voice, video, files
 - [Command Reference](docs/commands.md) — OpenClaw CLI commands
+- [Changelog](docs/changelog/) — release notes ([latest: 1.5.4](docs/changelog/1.5.4.md))
 
 

README.zh.md

@@ -411,5 +411,6 @@ openclaw gateway restart
 
 - [富媒体指南](docs/qqbot-media-guide.md) — 图片、语音、视频、文件
 - [命令参考](docs/commands.md) — OpenClaw CLI 常用命令
+- [更新日志](docs/changelog/) — 各版本变更记录（[最新: 1.5.4](docs/changelog/1.5.4.md)）
 
 

docs/changelog/1.5.4.md

@@ -0,0 +1,31 @@
+# 1.5.4
+
+## 中文
+
+### 🐛 修复
+
+- **修复多账户并发时 Token 串号问题**：将 `api.ts` 中的全局 Token 缓存（单变量）重构为按 `appId` 隔离的 `Map`，解决多个机器人同时运行时 Token 互相覆盖导致 `11255 invalid request` 报错的问题。
+- **Token 后台刷新支持多实例**：`clearTokenCache()` 和 `stopBackgroundTokenRefresh()` 改为接受 `appId` 参数，各账户独立管理。
+- **修复 `openclaw message send` 向非默认账户发消息失败**：未指定 `--account` 时 `accountId` 始终 fallback 为 `"default"`，导致用非默认机器人的 OpenID 发消息时 Token 与目标不匹配返回 500 错误。现已在文档中说明需通过 `--account` 参数指定目标机器人。
+
+### ✨ 新增
+
+- **多账户配置文档**：README 新增「多账户配置」章节，说明如何配置和使用多个 QQ 机器人。
+- **调试日志增强**：`channel.ts` 新增 `[qqbot:channel]` 前缀的详细日志，覆盖 account 解析、消息发送、网关启动全链路。
+- **API 日志前缀**：所有 API 请求日志加上 `[qqbot-api:${appId}]` 前缀，方便多实例排查。
+
+---
+
+## English
+
+### 🐛 Fixes
+
+- **Fix Token collision in multi-account concurrent mode**: Refactored the global Token cache in `api.ts` from a single variable to a per-`appId` `Map`, resolving `11255 invalid request` errors caused by Token overwrite when multiple bots run simultaneously.
+- **Per-instance background Token refresh**: `clearTokenCache()` and `stopBackgroundTokenRefresh()` now accept an `appId` parameter for independent per-account management.
+- **Fix `openclaw message send` failing for non-default accounts**: Without `--account`, `accountId` always fell back to `"default"`, causing a 500 error when sending to an OpenID belonging to a different bot (Token/target mismatch). Documentation now clarifies that `--account` must be specified for non-default bots.
+
+### ✨ New
+
+- **Multi-account documentation**: Added "Multi-Account Setup" section to README, explaining how to configure and use multiple QQ bots.
+- **Enhanced debug logging**: Added detailed `[qqbot:channel]` prefixed logs in `channel.ts`, covering account resolution, message sending, and gateway startup.
+- **API log prefix**: All API request logs now include `[qqbot-api:${appId}]` prefix for easier multi-instance debugging.