菜单
钉钉群聊与消息。Use when 用户提到 发消息/单聊/群聊/建群/拉人进群/改群名/搜索群/群成员管理/@消息/收藏消息/撤回消息/机器人群发/Webhook通知/发图片或文件到群。Distinct from dingtalk-ding(紧急DING消息/短信/电话)、dingtalk-mail(邮件)、dingtalk-edu-group(班级群)。命令前缀：dws chat。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
管理钉钉产品能力(AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/AI听记/邮箱/在线电子表格/知识库等)。当用户需要操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库时使用。
钉钉个人 IM 事件长连接监听、订阅与消费，覆盖消息接收、指定发送人、已读、撤回和表情回应，输出 NDJSON 到 stdout。Use when 用户提到 监听个人消息事件、被@消息、监听单聊或群消息、监听某人发送的消息、监听消息已读、监听消息撤回、监听消息贴表情或表情回应、实时接收钉钉事件、用事件驱动 Agent。命令前缀：dws event。
钉钉多组织 / profile 管理与跨组织取数。Use when 用户说 切换组织/换组织/跨组织/另一个钉钉/别的公司/多组织/看登录了哪些组织/profile，或在当前组织找不到群/人/数据需要去其他组织找。命令前缀：dws profile / dws auth / 全局 --profile。
dws 多 skill 模式的公共参考——认证、全局参数、Schema 命令发现、多组织 / --profile 规则、安全底线。所有 dingtalk-* 子 skill 执行前先读本 skill。命令前缀：dws。
钉钉通讯录查询与组织管理（用户、部门、角色、花名册、离职员工、创建企业、企业账号、邀请员工）。Use when 用户说 查部门/我的信息/按 userId 查/离职员工/创建企业/企业账号/邀请员工。Distinct from dingtalk-aisearch(模糊搜人首选：找同事/查上下级/谁负责)。命令前缀：dws contact。
钉钉开放平台企业内部应用管理：应用查询/创建/修改/删除/停启、凭证、权限点、成员、安全配置、网页应用、机器人、版本发布。Use when 用户说 开发者后台应用/开放平台应用/企业内部应用/agentId/clientId/appKey/appSecret/customKey/应用权限/权限点/scopeValue/创建机器人/智能体机器人/机器人配置/机器人回调/IP白名单/登录重定向/端内免登/应用版本/版本发布/发布审核/选审批人/把机器人接到本地调试/connect。
| name | dingtalk-chat |
| description | 钉钉群聊与消息。Use when 用户提到 发消息/单聊/群聊/建群/拉人进群/改群名/搜索群/群成员管理/@消息/收藏消息/撤回消息/机器人群发/Webhook通知/发图片或文件到群。Distinct from dingtalk-ding(紧急DING消息/短信/电话)、dingtalk-mail(邮件)、dingtalk-edu-group(班级群)。命令前缀：dws chat。 |
| cli_version | >=0.2.14 |
| metadata | {"category":"product","stability":"experimental","requires":{"bins":["dws"]}} |
🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。全部 dingtalk-* skill 已通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（
dws skill setup --mode mono）。问题请提 issue 反馈。
PREREQUISITE: Read the
dws-sharedskill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. Thedwsbinary must be on PATH.
⚠️ 命令可用性以当前 dws 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果
dws <cmd> --help不存在，说明当前版本未暴露该命令。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用dws <cmd> --help或--dry-run验证。
命令参考：chat.md；表情：chat-emoji-list.md；剧本：01-messaging.md。
以下 shortcut 来自独立于 Runtime Schema 的公开 catalog。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 dws shortcut list --service chat --format json 读取参数、约束、风险和示例，并以 dws chat <shortcut> --help 核对当前 Cobra flags；不要对 + 路径调用 dws schema。
| Shortcut | 风险 | 适用场景 |
|---|---|---|
dws chat +at-me | read | 查最近 @我 的消息（自动算时间窗，投影发送人/时间/内容/会话） |
dws chat +bot-find | read | 搜索全部可用机器人（含他人/官方，返回 openDingTalkId 可发单聊） |
dws chat +bot-search | read | 搜索当前用户自己创建的机器人 |
dws chat +broadcast | write | 按姓名逐一给多个人群发同一条单聊消息（自动解析 userId、逐个发送） |
dws chat +category-create | write | 创建用户自定义会话分组 |
dws chat +category-delete | high-risk-write | 删除用户自定义会话分组 |
dws chat +category-list | read | 获取用户自定义会话分组 |
dws chat +category-rename | write | 更新用户自定义会话分组的名称 |
dws chat +chat-bots | read | 查看群内所有机器人 |
dws chat +chat-dismiss | high-risk-write | 解散群聊（不可逆，需群主权限） |
dws chat +chat-invite-url | read | 获取群邀请链接 |
dws chat +chat-list-all | read | 分页拉取我加入的所有群列表 |
dws chat +chat-list-join-requests | read | 分页拉取入群验证记录 |
dws chat +chat-list-mine | read | 拉取我创建/管理的群 |
dws chat +chat-mute | write | 全员禁言 / 取消全员禁言 |
dws chat +chat-role-add | write | 添加群身份 |
dws chat +chat-role-list | read | 拉取会话的群身份列表 |
dws chat +chat-role-query-user | read | 查询群成员的群身份 |
dws chat +chat-role-set-user | write | 设置用户的群身份（覆盖该用户的全部群身份） |
dws chat +chat-role-update | write | 更新群身份名称 |
dws chat +chat-search | read | 按关键词搜索群聊 |
dws chat +chat-set-admin | write | 设置 / 取消群管理员 |
dws chat +chat-set-history | write | 设置新成员入群可查看历史消息范围 |
dws chat +chat-update-alias | write | 设置群备注（仅自己可见） |
dws chat +chat-update-nick | write | 设置当前用户在群内的群昵称 |
dws chat +conversation-clear-all-red-point | write | 清除所有会话红点（全部已读） |
dws chat +conversation-info | read | 获取会话信息（群聊传 --group，单聊传 --open-dingtalk-id） |
dws chat +conversation-list | read | 分页获取当前用户的全部会话列表（单聊+群聊） |
dws chat +conversation-list-top | read | 拉取置顶会话列表 |
dws chat +dm | write | 按姓名直接给某人发单聊消息（自动解析 userId） |
dws chat +group-members | read | 按群名列出群成员（自动搜群解析 openConversationId） |
dws chat +messages-list-direct | read | 拉取单聊会话消息 |
dws chat +messages-list-pin | read | 拉取会话中钉住的消息列表 |
dws chat +messages-list-unread-conversations | read | 获取有未读消息的会话列表 |
dws chat +messages-mget | read | 根据消息 ID 批量查询消息（最多 50 条） |
dws chat +messages-query-send-status | read | 查询消息发送状态 |
dws chat +messages-read-status | read | 查询消息的已读/未读状态 |
dws chat +messages-send-by-webhook | write | 自定义机器人 Webhook 发送群消息 |
dws chat +messages-update-card | write | 流式更新卡片内容（最后一次 --flow-status 应为 3） |
dws chat +my-groups | read | 列出我加入的群，可按类型过滤并投影关键字段 |
dws chat +send-to-group | write | 按群名直接给群发消息（自动搜群解析 openConversationId） |
dws chat +unread-chats | read | 列出我有未读消息的会话（投影会话名/未读数/会话ID） |
| 用户说 | 命令 |
|---|---|
| "发消息给张三" | dws chat message send --open-dingtalk-id <id> --title "<标题>" --text "<内容>" |
| "发到XX群" | dws chat search --query "<群名>" → dws chat message send --group <openConversationId> --title "<标题>" --text "<内容>" |
| "建群" / "拉人进群" | dws chat group create / dws chat group members add |
| "改群名" / "踢人" | dws chat group rename / dws chat group members remove --yes（踢人不可逆，确认目标后加 --yes；踢群主会被 CLI 拦截，需先 transfer-owner） |
| "@我消息" | dws chat message list-mentions |
| "查群聊记录" | dws chat message list |
| "收藏/取消收藏这条消息" | dws chat message add-favorite / dws chat message remove-favorite（均需 openMessageId 和 openConversationId） |
| "查看我收藏的消息" | dws chat message list-favorites（默认 --cursor 0 --size 20） |
| "用机器人发消息" | dws chat message send-by-bot --robot-code <code> --group <id> --title "<标题>" --text "<内容>" |
| "Webhook 推一条" | dws chat message send-by-webhook --token <token> --title "<标题>" --text "<内容>" |
| "撤回我发的消息" | dws chat message recall（撤回当前用户发送的消息） |
| "撤回机器人消息" | dws chat message recall-by-bot --robot-code <code> --group <openConversationId> --keys <processQueryKey>（撤回机器人发的） |
注：
chat message send的--title可选（不传时用正文首行作标题）；send-by-bot/send-by-webhook的--title必填。
dingtalk-contact 或 dingtalk-aisearch 拿 openDingTalkId / userIddt_media_upload 上传 → python scripts/extract_media_id.py "<URL>" 提取 mediaId → 再用 --media-iddingtalk-dingdingtalk-mail