DingTalk-Real-AI/dingtalk-openclaw-connector v0.8.24-beta.0

v0.8.24-beta.0 - AI Card Gateway Methods + Card Bridge 优化 / AI Card Gateway Methods + Card Bridge Optimizations

on GitHub

社区验证版本 — 计划 ~1 周观察期后晋升为正式版 v0.8.24。

Community validation release — planned to promote to GA v0.8.24 after ~1 week of community validation.

✨ 本次重点 / Highlights

AI Card Gateway Methods (#603)

新增两个 gateway method，暴露钉钉 AI Card 的创建与更新能力，外部 OpenClaw tool/plugin 可直接创建和更新钉钉 AI Card：

• dingtalk-connector.card.create — 创建 AI Card（支持 user:<userId> / group:<openConversationId> / cid... 目标）
• dingtalk-connector.card.update — 流式更新 / 完成 / 失败态结束卡片
• 同进程 card bridge — 同一 OpenClaw 运行时内的 plugin/tool 可直接复用 AI Card 能力，无需走 gateway RPC

Two new gateway methods exposing DingTalk AI Card create/update lifecycle for external OpenClaw tools:

• dingtalk-connector.card.create — Create AI Card (targets: user:<userId> / group:<openConversationId> / cid...)
• dingtalk-connector.card.update — Stream update / complete / fail a card
• In-process card bridge — plugins within the same OpenClaw runtime can call AI Card APIs directly without gateway RPC

Card Bridge Follow-up Optimizations (#611 / #612)

• cleanup timer 延迟初始化（仅 import 不再启动定时器）

• overflow eviction 改批量删除（消除 O(n²) 最差情况）

• 裸 cid target 收紧为显式正则（避免误匹配 cidxxx）

• 错误判定改 PublicError class + instanceof（文案修改不会静默降级）

• 补充错误处理测试

• Lazy cleanup timer init (no timer on bare import)

• Batch overflow eviction (eliminate O(n²) worst case)

• Strict cid target regex (reject cidxxx false matches)

• PublicError class for error discrimination (copy changes won't silently degrade)

• Error handling test coverage

🔒 兼容性 / Compatibility

• 纯增量能力，不影响现有回复链路和 AI Card 行为

• 现有 API / 配置 schema / 导出符号无破坏性变化

• 升级无需任何配置改动

• Purely additive — no changes to existing reply pipeline or AI Card behavior

• No breaking API / config schema / export changes

• Zero-config upgrade

📦 升级方式 / How to upgrade

openclaw plugins install @dingtalk-real-ai/dingtalk-connector@0.8.24-beta.0
openclaw gateway restart

或者 / or:

npm install @dingtalk-real-ai/dingtalk-connector@0.8.24-beta.0

⏭️ 后续节奏 / Next steps

• 2026-06-26 ~ 2026-07-03：社区使用反馈窗口（~1 周观察期）
• ～2026-07-03 之后：若无回归即晋升为正式版 v0.8.24
• 升级遇到问题请提交到 Issues

📄 完整 Release Notes：docs/RELEASE_NOTES_V0.8.24-beta.0.md

致谢 / Credits

感谢 @hugtale 贡献 AI Card gateway 能力（#603、#612）。

Full Changelog: v0.8.23...v0.8.24-beta.0