Release Notes - v0.8.2

🎉 新版本亮点 / Highlights

本次更新聚焦于多账号场景下的稳定性与正确性：修复了多账号配置时重复建立连接的问题，优化了 WebSocket 连接管理机制，并改进了消息处理逻辑，使长连接场景下的整体可靠性显著提升。

This release focuses on stability and correctness in multi-account scenarios: it fixes duplicate connection creation when multiple accounts are configured, improves WebSocket connection management, and refines message processing logic for significantly better reliability in long-lived connection scenarios.

🐛 修复 / Fixes

多账号重复启动问题 / Multi-account Duplicate Startup
修复了配置多个钉钉账号时，enabled: false 的账号仍会建立 WebSocket 连接的问题。现在插件会在启动时正确检查账号的 enabled 状态，禁用账号将保持 pending 状态直到 Gateway 停止，不再建立任何连接。
Fixed an issue where accounts with enabled: false would still establish WebSocket connections when multiple DingTalk accounts were configured. The plugin now correctly checks the enabled state at startup; disabled accounts remain in a pending state until the Gateway stops and no longer create any connections.
相同 clientId 账号去重 / Duplicate clientId Deduplication
修复了多个账号配置相同 clientId 时会建立重复连接的问题。通过静态配置分析，同一 clientId 只有列表中排在最前面的启用账号才会建立连接，后续重复账号会被自动跳过并记录日志。
Fixed an issue where multiple accounts sharing the same clientId would create duplicate connections. Using static configuration analysis, only the first enabled account with a given clientId in the list will establish a connection; subsequent duplicates are automatically skipped and logged.

✨ 功能与体验改进 / Features & Improvements

Onboarding 配置向导优化 / Onboarding Configuration Wizard Improvement
改进了钉钉连接器的配置引导逻辑：调整了凭据输入顺序（先 Client ID 后 Client Secret），优化了引导文案，使配置流程更清晰易懂。
Improved the DingTalk connector onboarding wizard: adjusted credential input order (Client ID first, then Client Secret), and refined the guidance text for a clearer and more intuitive setup experience.
会话 Key 构成遵循 OpenClaw 规范 / Session Key Follows OpenClaw Convention
会话上下文（sessionKey）的构成现在严格遵循 OpenClaw 标准规则，通过 channel、accountId、chatType、peerId 等字段组合唯一标识会话，并支持 sharedMemoryAcrossConversations 配置实现跨会话记忆共享。
The session context (sessionKey) now strictly follows OpenClaw conventions, uniquely identifying sessions via channel, accountId, chatType, and peerId fields. Also supports sharedMemoryAcrossConversations for cross-conversation memory sharing.
消息处理逻辑优化 / Message Processing Logic Optimization
重构消息处理流程，提升消息响应速度和处理可靠性，确保消息按序正确处理。
Refactored message processing flow to improve response speed and reliability, ensuring messages are processed correctly in order.

📥 安装升级 / Installation & Upgrade

# 通过 npm 安装最新版本 / Install latest version via npm
openclaw plugins install @dingtalk-real-ai/dingtalk-connector

# 或升级现有版本 / Or upgrade existing version
openclaw plugins update dingtalk-connector

# 通过 Git 安装 / Install via Git
openclaw plugins install https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector.git

🔗 相关链接 / Related Links

发布日期 / Release Date：2026-03-22
版本号 / Version：v0.8.2
兼容性 / Compatibility：OpenClaw Gateway 0.4.0+