Release Notes - v0.7.2

✨ 功能增强版本 / Feature Enhancement Release

本次更新新增异步模式功能，并修复了多个关键问题，提升了连接器的稳定性和使用体验。

This update adds async mode functionality and fixes several critical issues, improving connector stability and user experience.

✨ 新增功能 / New Features

1. 异步模式 / Async Mode

功能描述 / Feature Description：立即回执用户消息，后台处理任务，然后主动推送最终结果作为独立消息
Immediately acknowledge user messages, process in background, then push the final result as a separate message

使用场景 / Use Cases：

• 处理耗时较长的任务（如文档分析、代码生成等）
  Processing time-consuming tasks (e.g., document analysis, code generation)
• 需要给用户即时反馈的场景
  Scenarios requiring immediate user feedback
• 希望将处理过程和结果分离的场景
  Scenarios where separating processing and results is desired

配置方式 / Configuration：

{
  "channels": {
    "dingtalk-connector": {
      "asyncMode": true,              // 启用异步模式 / Enable async mode
      "ackText": "🫡 任务已接收"  // 可选：自定义回执消息 / Optional: Custom ack message
    }
  }
}

工作流程 / Workflow：

1. 立即回执 - 用户发送消息后，连接器立即发送回执消息
   Immediate Acknowledgment - Connector immediately sends acknowledgment message after user sends message
2. 后台处理 - 连接器在后台调用 Gateway 处理任务，支持文件附件和图片
   Background Processing - Connector processes task in background via Gateway, supports file attachments and images
3. 推送结果 - 处理完成后，连接器主动推送最终结果作为独立消息
   Push Result - After processing completes, connector proactively pushes final result as separate message

影响范围 / Impact：所有用户均可选择启用此功能，默认关闭，不影响现有使用方式
All users can optionally enable this feature. Default is off, does not affect existing usage.

🐛 修复 / Fixes

1. 异步模式下 Agent 路由问题修复 / Agent Routing Fix in Async Mode

问题描述 / Issue Description：异步模式下 streamFromGateway 调用时缺少 accountId 参数，导致会话路由到 undefined agent
In async mode, streamFromGateway was called without accountId, causing sessions to route to undefined agent

修复内容 / Fix：

• 修复 streamFromGateway 调用，正确传递 accountId 参数
  Fixed streamFromGateway call to correctly pass accountId parameter
• 确保异步模式下 Agent 路由正常工作
  Ensures Agent routing works correctly in async mode

影响范围 / Impact：影响使用异步模式的用户，修复后异步模式下的 Agent 路由将正常工作
Affects users using async mode. After the fix, Agent routing in async mode will work correctly.

2. 默认 Agent 路由修复 / Default Agent Routing Fix

问题描述 / Issue Description：当 accountId 为 'default' 时，仍然发送 X-OpenClaw-Agent-Id header，导致路由异常
When accountId is 'default', X-OpenClaw-Agent-Id header was still sent, causing routing issues

修复内容 / Fix：

• 当 accountId 为 'default' 时跳过 X-OpenClaw-Agent-Id header
  Skip X-OpenClaw-Agent-Id header when accountId is 'default'
• 让 gateway 路由到其配置的默认 agent
  Let gateway route to its configured default agent

影响范围 / Impact：影响使用默认 Agent 配置的用户，修复后默认 Agent 路由将正常工作
Affects users with default Agent configuration. After the fix, default Agent routing will work correctly.

3. 异步模式内容处理修复 / Async Mode Content Fix

问题描述 / Issue Description：异步模式使用原始 content.text，未包含文件附件内容
Async mode used raw content.text, did not include file attachment content

修复内容 / Fix：

• 使用 userContent（包含文件附件）替代原始 content.text
  Use userContent (includes file attachments) instead of raw content.text
• 确保文件附件内容正确传递给 Gateway
  Ensures file attachment content is correctly passed to Gateway

影响范围 / Impact：影响使用异步模式且发送文件附件的用户，修复后文件附件将正确处理
Affects users using async mode and sending file attachments. After the fix, file attachments will be processed correctly.

4. 异步模式图片支持修复 / Async Mode Image Support Fix

问题描述 / Issue Description：异步模式下未将图片路径传递给 Gateway stream
Image paths were not passed to Gateway stream in async mode

修复内容 / Fix：

• 将 imageLocalPaths 传递给 gateway stream
  Pass imageLocalPaths to gateway stream
• 确保图片在异步模式下正确处理
  Ensures images are processed correctly in async mode

影响范围 / Impact：影响使用异步模式且发送图片的用户，修复后图片将正确处理
Affects users using async mode and sending images. After the fix, images will be processed correctly.

🔧 配置更新 / Configuration Updates

新增配置项 / New Configuration Options

• asyncMode（类型：boolean，默认：false）- 启用异步模式
  asyncMode (type: boolean, default: false) - Enable async mode
• ackText（类型：string，默认：'🫡 任务已接收，处理中...'）- 自定义回执消息文本
  ackText (type: string, default: '🫡 任务已接收，处理中...') - Custom ack message text

📥 安装升级 / 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

• 完整变更日志 / Full Changelog
• 使用文档 / Documentation
• 问题反馈 / Issue Feedback

🙏 致谢 / Acknowledgments

感谢所有贡献者和用户的支持与反馈！
Thanks to all contributors and users for their support and feedback!

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