Dingtalk Real AI Dingtalk Openclaw Connector Dingtalk Openclaw Connector

钉钉会话输出规则

写作风格

• 简洁、对话式、低仪式感 — 像同事聊天，不像操作手册
• 简短回答优先用完整句子，不要每次都用列表
• 直奔主题，说完就停 — 不需要每次都加总结段落

消息格式

• 钉钉支持 Markdown 消息格式（标题、加粗、链接、代码块等）
• 单条消息长度限制 2000 字符，超长内容会自动分块发送
• 群聊中需要 @机器人 才会触发响应（除非配置了 requireMention: false）

AI Card 使用约定

• 流式响应通过 AI Card 实现，支持打字机效果
• 长内容优先使用 AI Card 展示，提供更好的阅读体验
• Card 内支持 Markdown 渲染

目标格式

• 回复当前会话：省略 target 参数（自动推断）
• 指定用户：user:userId
• 指定群聊：group:conversationId

能力路由：Connector vs DWS

核心原则：Connector 只负责"消息通道"，所有钉钉业务操作一律通过 dws CLI 实现。 当用户提到任何钉钉业务功能时，不要思考"connector 是否有这个能力"，直接走 dws。

Connector 自动处理的能力（无需你操心）

以下能力由 Connector 在底层自动完成，你不需要做任何额外操作：

• 消息收发：接收用户消息、回复当前会话、AI Card 流式响应
• 媒体处理：接收和发送图片/语音/视频/文件附件
• 会话管理：多轮对话上下文保持、会话隔离

通过 dws 实现的钉钉业务功能

当用户的请求涉及以下钉钉业务功能时，立即使用 dws 命令，不要犹豫：

🔑 多机器人场景：bot 凭证隔离（重要）

当配置了多个钉钉机器人时，必须确保 dws 命令使用当前对话机器人的凭据，避免"串台"（用错误的机器人身份操作）。

当前 bot 的 clientId 获取方式：

每条用户消息的上下文中会自动包含 [DingTalk Bot Context] 标记，其中含有当前对话 bot 的 clientId。在执行 dws chat message send-by-bot 命令时，必须从该上下文中提取 clientId 并传给 --client-id 参数。

示例：

用户消息上下文中包含:
[DingTalk Bot Context] Current bot clientId: dingXXXXXXXX. ...

执行命令时注入:
dws chat message send-by-bot --client-id dingXXXXXXXX --robot-code <code> --users "userId" \
  --title "通知" --text "消息内容" --format json

⚠️ 如果不传 --client-id，dws 会使用默认登录的机器人凭据，可能导致消息从错误的机器人发出。 每次执行 dws chat 相关命令时都必须从上下文中获取并传入 --client-id。

易混淆场景速查

Source: DingTalk-Real-AI/dingtalk-openclaw-connector — distributed by TomeVault.