教程
钉钉机器人:建应用、开 Stream、拿凭据
钉钉这条是团队用的:同事私聊机器人,或在群里 @ 它,它按提问人自己的身份去问那个人的代理,所以每个人看到的答案都只到他该看到的那一层。
它走钉钉的「Stream 模式」:你的电脑主动连钉钉,不需要公网地址、不用配回调网址。只要 Agents 工坊在这台电脑上开着,它就能收能回。
一、在钉钉开发者后台建一个应用
- 打开 钉钉开发者后台,用管理员账号登录,进应用开发 → 企业内部应用 → 创建应用,填名字和图标。
- 进应用 → 添加应用能力 → 添加机器人,打开机器人配置:
- 填机器人名字、简介、头像;
- 消息接收模式选「Stream 模式」(不要选 HTTP 模式);
- 保存。
- 凭证与基础信息 → 复制 Client ID 和 Client Secret(老版本后台叫 AppKey / AppSecret)。
- 版本管理与发布 → 发布。发布之后同事才能在钉钉里找到这个机器人。
二、填进 Agents 工坊
这一步只有负责人或公司管理员能做;别人在卡上只看得到状态。
- 回到「消息渠道」页的钉钉机器人卡,填 Client ID 和 Client Secret,点保存并连接。
- 卡上变成「在收信」就对了。
Client Secret 直接进本机加密库,不经 AI、不进日志、不会再显示出来。
三、每个人绑一次自己的账号
机器人只替认得的同事作答。第一次用的人:
- 在「消息渠道」页的钉钉卡上点绑定我的账号,会出一串 6 位数。
- 在钉钉里私聊机器人,发「绑定 123456」(换成你的那 6 位数)。10 分钟内有效,只能用一次。
- 它回「绑好了」之后,私聊问、或者在群里 @ 它问都可以;群里它会 @ 回提问的人。
想让它进群:群设置 → 机器人 → 添加机器人 → 选你建的那个企业内部应用机器人。
它不做的事
- 要你定的事不在钉钉里定:卡片只投「摘要 + 去工作台处理」的链接,不放通过 / 驳回按钮。
- 不认识的人不代答:没绑过的账号问它,它只回一句「先去绑定」。
- 群里只理 @ 了它的消息。
常见问题
- 卡上说「Client ID 或 Client Secret 不对,或者应用还没开 Stream 模式」:去「凭证与基础信息」核一下,机器人配置里确认选的是 Stream 模式,然后点重填凭据。
- 卡上说「暂时连不上钉钉」:多半是网络问题,它会自己重试。
- 很久以前的消息它不回了:钉钉给每条消息的回复地址有有效期,过了就回不了,重新问一句就好。
- 问了它没马上答:它会先回「收到,我查一下」,查完再回一条。
- 卡上说「断了,在重连」:连接掉了(网络或代理断过),它在自己重连,连上就恢复。断着的时候发的消息可能收不到,连上后再问一次。
- 电脑关了还能回吗? 不能。Stream 连接跟着这台电脑走,电脑睡眠、断网或 Agents 工坊退出时它都收不到。