如何把 Multica agent 接入钉钉Stream 模式机器人与 AppKey/AppSecret【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica目标很明确把一个 Multica agent 连接到钉钉机器人之后工作区成员就能在钉钉私聊或群里直接给 agent 派活对话和执行记录会保存在 Multica 工作区里。完成接入的标志是给 Bot 发消息后agent 能在私聊中回复处理结果并且Bot触发的消息同样生效。两点前提需要先知道连接操作必须由agent 的创建者或工作区 owner/admin执行agent 与钉钉 Bot 是一对一绑定一个 agent 只连一个 Bot想在同一平台用多个 agent就要为每个 agent 各建一个 Bot。钉钉集成属于社区维护的渠道随每个版本发布但没有官方支持 SLA遇到问题需要去项目的 GitHub issues 反馈。在钉钉开放平台创建 Stream 模式机器人到钉钉开放平台open-dev.dingtalk.com创建一个企业内部应用。开启机器人能力并把消息接收模式设为Stream 模式。Multica 的钉钉通道走的就是平台长连接Stream 模式所以这一步的模式选择是接入能否成功的关键。检查权限机器人发消息权限qyapi_robot_sendmsg默认已添加如果希望 Multica 里显示 Bot 的名称还要手动添加钉群基础信息管理权限qyapi_chat_manage否则集成页看不到群信息。进入凭证与基础信息页面复制Client IDAppKey和Client SecretAppSecret后面要填进 Multica。自托管部署先配置 AppSecret 加密密钥使用 Multica Cloud 可以直接跳过本节。自托管部署在连接钉钉之前必须先配置一个用于加密存储钉钉AppSecret的密钥MULTICA_DINGTALK_SECRET_KEYbase64-encoded 32-byte key生成方式openssl rand -base64 32把输出的 base64 字符串填进MULTICA_DINGTALK_SECRET_KEY然后重启 API 服务再去 Multica 里连接钉钉。这个密钥必须长期保存一旦更换或丢失已存储的 token 无法解密只能重新走一遍连接流程。账号绑定链接使用MULTICA_APP_URL环境变量未设置时回退到FRONTEND_ORIGIN。这个地址必须指向工作区成员实际能访问到的 Multica 地址否则第 5 步收到的绑定链接会打不开。在 Multica 中连接 agent 与钉钉回到 Multica打开Agents → 你的 agent → Capabilities → Integrations。点击Connect DingTalk。填入上一步拿到的AppKey和AppSecret提交。关联钉钉账号与 Multica 账号连接提交后还不能直接派活发消息的人需要完成账号绑定在钉钉上私聊 Bot或者在群里 它一次就会触发关联请求。你会在 Bot 的私聊对话框里收到一个链接有效期约 15 分钟。打开链接并登录 Multica看到连接成功的提示即完成。绑定把平台账号与该成员在当前工作区中的身份关联起来Multica 只在绑定完成后才会运行 agent且每条消息都会重新检查绑定和工作区成员身份——成员退出工作区后Bot 就无法再触达该 agent。判断接入是否成功绑定完成后给 Bot 发一条消息agent 处理完会在同一私聊里回复结果同时 Multica 工作区里能看到对应的会话和执行记录。派活方式与消息限制私聊直接给 Bot 发消息结果回复在私聊里。群聊把 Bot 加入群后发送your-bot 消息。注意每次追问都要重新 一次——Bot 只处理 它的消息未 的群消息既不触发 agent也不会进入它的会话上下文。钉钉按会话隔离 session每个私聊或群各自延续自己的会话不会串到一起。图片私聊和群聊都支持图文混排支持 PNG、JPEG、GIF、WebP、BMP每条消息最多 4 张图片每张不超过 10 MB。文件和语音消息目前不支持。常用指令作为普通消息发送即可/issue 标题或/issue 标题{换行}详细描述创建 Multica issue 并自动指派给该 Bot 连接的 agent同条消息里的图片会作为附件挂到 issue 上。/issue是命令而非聊天轮次不会在 Multica Chat 里留下记录。/new [消息]新建一个空的 Multica Chat后续钉钉消息路由过去带消息时该消息作为第一轮。原 Chat 仍保留可用。/clear [消息]保留当前 Chat但下一条消息开始使用新的 agent 可见上下文带消息时该消息作为边界后的第一轮。完整历史仍可在 Multica 中查看。管理连接与断开在Agents → 你的 agent → Capabilities → Integrations页面agent 创建者和工作区 owner/admin 可以连接或断开钉钉。连接成功后这里会显示 Bot 名称、它成功处理过消息的钉群以及 Bot 在群里的活跃数据有 agent 读权限的成员可见。最近 90 天没有成功处理消息的群归入Long inactive展开时加载。Settings → Integrations列出当前工作区里所有连接了钉钉的 agent 及其活跃数据。owner/admin 可以在此断开任意 agent 的钉钉连接断开后 Bot 停止接收消息但安装记录保留用于审计。owner/admin 还可以“忘记”某个群——只是从列表移除不删除对话和消息之后若已绑定钉钉账号的成员在该群再次 Bot 且 Multica 成功接收群会重新出现。相关文档钉钉 Bot 集成、聊天集成Channel 引擎与授权机制、环境变量参考。【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考