ARTICLE · 1278545
把DeepSeek接入钉钉 官方插件使用教程
钉钉 × DeepSeek Harness
人不在电脑前，也能派活、看进度、批操作
插件包 @dingtalk-real-ai/dsh-dingtalk
维护方 钉钉 DingTalk难度 照着做就行
日期 2026.10 （DSH 仍处于开发者预览阶段）
一句话 钉钉这个插件不是简单地把消息转发到手机。它把本机 DSH 会话整个接到钉钉里：你在外面发一句话，电脑上的 Agent 接着干；它遇到敏感操作，会在钉钉卡片上等你点头。
读完你会得到
·通勤路上派活：地铁里想起一份周报没写，直接在钉钉私聊机器人说清楚，电脑上的 DSH 开始跑。
·会上批操作：Agent 要删文件、改配置，审批卡片直接推到钉钉，不用回工位。
·顺手查日程：开了 DWS 之后，可以让它查日历、发群消息、记待办，不用再切应用。
另外附上：安装流程图、配置对照表、常见问题排查顺序、安全提醒和官方资料链接。
01使用场景
先说清楚它解决什么问题。如果下面这几条都不沾边，别装，装了也是负担。
场景 1 通勤路上派活 地铁里想起一份周报没写，直接在钉钉私聊机器人说清楚，电脑上的 DSH 开始跑。
场景 2 会上批操作 Agent 要删文件、改配置，审批卡片直接推到钉钉，不用回工位。
场景 3 顺手查日程 开了 DWS 之后，可以让它查日历、发群消息、记待办，不用再切应用。
不适合 公司安全策略不允许外部机器人操作本机文件的，或者你只在电脑前干活、不需要手机接力的，先别装。
02准备工作
需要 | 说明 |
Node.js | 22.19.0 或 >=24.0.0，向导会自己检查 |
DSH | web profile 能正常启动，先跑通一次对话 |
钉钉 | 手机装好，并且是目标组织的成员 |
系统 | macOS / Linux 正式支持，Windows 还是实验性 |
版本号不是摆设。DSH 还在快速迭代，插件和宿主对不上，最常见的表现就是装完不显示、扫码乱码、启动报错。
03安装步骤
先把整个流程看一眼，再往下做
第 1 步 运行安装向导
一行命令，向导会检测 DSH、装连接器、拉起配置流程。
npx @dingtalk-real-ai/dsh-dingtalk@latest setup
第 2 步 扫码建机器人
手机钉钉扫码，确认组织、名称、简介，点创建。已有应用就直接填 Client ID 和 Secret。
扫码创建钉钉机器人应用
第 3 步 选三项配置
DWS 工具按需开；图片模式选 Auto；发送者和群聊范围先收窄。
发送者、群聊、DWS 三项配置
第 4 步 启动并等连接
跑 dsh web，日志里出现 connect success 和 stream connected 才算通了。
dsh web
第 5 步 私聊绑定管理员
向导给一串一次性口令，十分钟内私聊机器人发送，别发群里。
/bind
绑定管理员的一次性口令
04配置与使用
项目 | 怎么配 / 能做什么 |
DWS 工具 | 开：能查日历、群聊、待办；不开也能正常收发消息 |
图片模式 | Auto 最稳；Always 不会把纯文本模型变成视觉模型 |
发送者范围 | 默认所有人；公司账号改成仅管理员或指定成员 |
群聊范围 | 默认所有群；真实项目按最小必要开放 |
装完先把一条最简单的任务跑通，再逐步加权限和范围。不要一上来就把所有开关打开。
05常见问题
·电脑睡了它就离线：进程停、电脑休眠、断网，机器人都不会再执行任务，云端不会替你接着跑。
·绑定命令别发群：谁拿到那串口令，谁就能成为唯一管理员。
·默认是全开放的：首次安装允许所有人、所有群。公司用一定要改。
·Windows 别上生产：官方明确写的是实验性平台，出问题不好排查。
06安全提醒
先看这一条 机器人能驱动本机 Agent，等于把电脑的一部分操作权交出去。绑定后先改发送者和群聊白名单，敏感审批只留给管理员。
07参考资料
· DeepSeek Harness 钉钉插件 · 钉钉开放平台https://open.dingtalk.com/document/development/deepseek-harness-dingtalk-integration
· npm · @dingtalk-real-ai/dsh-dingtalkhttps://www.npmjs.com/package/@dingtalk-real-ai/dsh-dingtalk
以上链接截至 2026 年 10 月。DSH 和插件都还在快速迭代，界面、包名和参数以官方页面当前版本为准。
