Agent 用例站

← 用例 · 企业协作

钉钉官方插件接入 OpenClaw（文档 · 日程 · 待办）

用钉钉官方 OpenClaw Channel 插件，扫码或手动填凭证，把本机 OpenClaw Agent 接到钉钉：私聊/群聊收发、AI 卡片流式回复，并可操作钉钉文档、日程、待办与 AI 表格。

OpenClaw钉钉

来源：GitHub · 2026-10-13 · 原文

做法 / Prompt

先确认本机已安装并可运行 OpenClaw（openclaw -v ≥ 2026.8.1；不足则按 https://openclaw.ai 升级）。然后执行：npx -y @dingtalk-real-ai/dingtalk-connector install ；用钉钉手机 App 扫终端二维码「一键创建新机器人」。成功后跑 openclaw gateway restart，在钉钉私聊机器人发一条测试消息验收。AppSecret / clientSecret 只留在本机 ~/.openclaw/，不要写进公开仓或对话。

痛点

人在钉钉里协作，Agent 却在另一套终端或海外 IM；想让助手直接收发钉钉消息，并顺手改文档、查日程、建待办，又缺官方可复现通道。站内已有飞书 / 微信 / 企微入口，但钉钉侧长期空白。

与站内「飞书 / 微信控制 Claude Code · Cursor · Codex（ChatCCC）」不同：那条是 编程 CLI 接到飞书或微信；本条是 OpenClaw Agent 经 钉钉官方 Channel 插件 进钉钉，并可调用文档 / 日程 / 待办等钉钉能力。

做法

  1. 前置：本机已安装并正常运行 OpenClaw（开源个人/团队助手 Gateway）。插件 README 要求宿主 OpenClaw ≥ 2026.8.1（openclaw -v）；旧版可先 npm install -g openclaw@2026.8.1，或继续用文档标明的旧插件版本后再升级。
  2. 一键安装 + 扫码（推荐）：执行 npx -y @dingtalk-real-ai/dingtalk-connector install。终端出现钉钉授权二维码后，用 钉钉手机 App 扫码并点「一键创建新机器人」。看到 Success! Bot configured. 后执行 openclaw gateway restart。npm 包名：@dingtalk-real-ai/dingtalk-connector。
  3. 扫码失败时：插件本身通常仍会装上；按仓库 手动配置指南 在钉钉开放平台创建应用/机器人，把 AppKey（clientId） 与 AppSecret（clientSecret） 写入本机 ~/.openclaw/openclaw.json 的 channels.dingtalk-connector（Windows 为用户目录下 .openclaw/openclaw.json）。Secret 只走本机配置。
  4. 能做什么（以 README 能力表为准）：群聊/私聊收发与 Markdown；AI Card 流式与交互式状态卡片；钉钉文档创建/追加/搜索；个人待办；AI 表格读写；日历日程与参会人；日报/周报提交；多 Agent 路由与权限策略。富媒体（图/音/文件）按文档支持。群待办、云盘等标注 Coming Soon 的能力不要当作已上线验收项。
  5. 安全（README 必读）：授权后 Agent 会以你的用户身份在授权范围内操作钉钉资源；存在幻觉与越权风险。官方建议先当 个人对话助手，勿直接丢进企业生产群；不要随意放宽默认安全配置。凭证与会话状态留本机。

验收

  • openclaw -v 满足插件要求；npx … install 成功或手动 channels.dingtalk-connector 已启用。
  • openclaw gateway restart 后，钉钉私聊（或约定群）能向机器人发一条消息并收到回复（或 AI 卡片流式更新）。
  • clientSecret / AppSecret 仅在本机 ~/.openclaw/，未进 git；未在公开对话中粘贴。

来源