企微接了、飞书也接了，办公 IM 三件套就差钉钉——而钉钉恰恰是很多国内企业实际在用的那个。OpenClaw 接上钉钉，等于把 Agent 直接送进企业工作流：群里 @ 机器人就发任务、日报周报自动推到群、告警提醒直达个人。
这篇讲 OpenClaw 接钉钉的完整流程：开放平台建应用、机器人权限、MCP 配置、消息收发到任务闭环，一步步来，照着做就能跑通。
先搞明白：OpenClaw 接钉钉的架构
整体是三层：钉钉开放平台（应用和机器人，管消息收发与权限）→ MCP 服务（协议桥，把钉钉 API 翻译成 Agent 能调的工具）→ OpenClaw（Agent 本体，负责理解任务、编排动作）。
这个骨架和接企业微信（OpenClaw 怎么接企业微信）、接飞书（OpenClaw 怎么接飞书）完全一样，换的只是平台侧的配置。如果你已经接过其中任意一个，剩下的就是照着钉钉的界面点一遍。
第一步：钉钉开放平台建企业内部应用
用企业管理员账号登录钉钉开放平台（open.dingtalk.com）——注意，个人账号建不了企业应用，这一步必须企业认证账号。
路径：应用开发 → 企业内部开发 → 创建应用，类型选「机器人」。创建后在「凭证与基础信息」页面拿到两样东西：AppKey（应用唯一标识，相当于账号）和 AppSecret（应用密钥，相当于密码）。
关键提醒：AppSecret 只在首次生成时显示一次，关掉页面就再也看不到了，只能重置（重置后旧密钥立即失效）。拿到手第一时间存进环境变量或密钥管理，别贴进代码、别提交到仓库——这就是 Agent 的密钥边界：密钥进了仓库，等于把家门钥匙贴在门牌上。
第二步：配置机器人并申请权限
进入应用详情，开启机器人能力，消息接收模式选 Stream 模式（WebSocket 长连接）——这个模式不需要公网域名和回调地址，自部署场景非常友好，不用折腾反向代理。
然后去权限管理申请必要的权限：核心是「企业机器人消息推送」（权限码 qyapi_robot_sendmsg），不申请它，机器人一发消息就报 AccessDenied；如果还想按员工姓名找人，再申请「通讯录部门信息读权限」和「通讯录成员信息读权限」。
权限按最小够用申请：只需要发消息的就别开通讯录读取；要读通讯录就别顺手开别的写权限。给 Agent 的权限越大，出事半径越大，AI Agent 权限管理 的最小权限原则在钉钉里一样适用。
第三步：OpenClaw 里配置 MCP 服务
在 OpenClaw 的 MCP 配置里加一个 dingtalk 服务，和接其他 MCP 工具是同一个套路（OpenClaw 怎么接 MCP 工具）。核心是三个环境变量：
DINGTALK_APP_KEY（应用 AppKey）、DINGTALK_APP_SECRET（应用 AppSecret）、DINGTALK_AGENT_ID（部分实现需要，用于指定机器人实例）。启动方式二选一：npx 直接跑，或者用 docker 起容器，选哪种取决于你的部署环境——OpenClaw 部署到服务器 时用 docker 方式更省心。
配好后 OpenClaw 就能调用钉钉的工具了：单聊发送（按 userId 或中文姓名）、群聊发送、批量发送（最多 20 人）。工具名和参数在 MCP 服务文档里有，按需选用。
第四步：消息收发与任务闭环
两条链路都要跑通：
主动发——Agent 干完活把结果推给指定的人或群。日报、周报、告警、审批提醒都走这条，配合 OpenClaw 定时发日报周报 的定时机制，早上九点自动把昨天的数据总结推到群里，这就是最常见的落地形态。
被动收——用户在钉钉群里 @ 机器人下指令，消息经 MCP 进 OpenClaw，Agent 理解任务、调用工具、干完活把结果回传到群里。这条链路把「消息 → 任务 → 执行 → 回传」串成了闭环，进阶一点还能把它嵌进 多 Agent 编排：群里收到需求，主代理拆任务、子代理分头干、结果汇总回群。
常见坑与排查
AccessDenied：权限没开通，或应用没安装到企业。去权限管理确认「企业机器人消息推送」已开。
AppSecret 丢失：只能重置，旧密钥立即失效，所有依赖签名的接口报 401，线上服务要同步换。所以第一步拿到就存好，别拖。
按姓名发消息失败：没开通讯录权限，或者企业里有重名——实现通常会拒绝发送并列出重复的 userId，用 userId 发送最稳。
Stream 模式连不上：多半是网络代理问题，检查出网是否被墙或代理干扰。
权限给太大：应用能读全企业通讯录，是常见的安全隐患。定期检查权限配置，不需要的权限就关掉。
优缺点与适合人群
优点：钉钉在企业侧覆盖广、Stream 模式免公网、MCP 生态现成、群机器人交互门槛低。缺点：必须企业管理员账号才能建应用、权限申请要走审核流程、AppSecret 管理要求高。
最适合：企业内部流程自动化——日报周报推送、审批提醒、客服应答、运维告警、群内问答机器人。个人玩票场景不建议（个人账号建不了企业应用），纯个人用 Telegram 之类更轻量的通道更合适。
总结
OpenClaw 接钉钉四步走：开放平台建应用拿 AppKey/AppSecret → 配置机器人开权限（Stream 模式 + 消息推送）→ OpenClaw 里配 MCP 环境变量 → 跑通主动发和被动收两条链路。两个核心提醒：AppSecret 只看一次，拿到就存好；权限最小够用，别给 Agent 打开全企业通讯录。接完之后，你的 Agent 才算真正进了企业的日常。
