Release Notes - v0.8.1

🎉 新版本亮点 / Highlights

本次更新专注于修复文件下载功能的关键问题。解决了用户发送文件到钉钉后无法下载到本地的 OSS 签名验证失败问题，确保文件和图片下载功能的稳定性。

This release focuses on fixing a critical file download issue. It resolves the OSS signature verification failure that prevented files sent to DingTalk from being downloaded locally, ensuring stable file and image download functionality.

🐛 修复 / Fixes

• 文件和图片下载 OSS 签名验证失败 / File and Image Download OSS Signature Verification Failure
  修复了 dingtalkHttp 实例默认携带的 Content-Type: application/json 请求头导致 OSS 预签名 URL 签名验证失败的问题。通过在下载请求中显式删除 Content-Type 请求头，确保文件和图片能够正常下载到 media/inbound/ 目录。同时添加了异常堆栈日志，便于后续问题排查。
  Fixed an issue where the default Content-Type: application/json header in the dingtalkHttp instance caused OSS pre-signed URL signature verification to fail. By explicitly removing the Content-Type header in download requests, files and images can now be downloaded successfully to the media/inbound/ directory. Also added exception stack trace logging for easier troubleshooting.

  影响范围 / Impact:

  • 文件下载功能 / File download functionality
  • 图片下载功能 / Image download functionality

  技术细节 / Technical Details:

  • 问题根源：OSS 签名基于所有请求参数（包括请求头）计算，额外的请求头导致签名不匹配
  • 解决方案：设置 headers: { 'Content-Type': undefined } 覆盖默认配置
  • 修改文件：src/core/message-handler.ts 中的 downloadFileToLocal 和 downloadImageToFile 函数

📥 安装升级 / 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
• Pull Request #300

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