octop v0.9.20 通过钉钉开放平台 stream 模式与企业内应用实现双向流式集成,支持卡片、文件及流式文本实时交互,并默认启用会话隔离与组织权限继承。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Octop v0.9.20 接入钉钉通道,不是走传统机器人 Webhook 的单向推送模式,而是基于其“Connector”架构和“多用户多 Agent”设计,以双向、流式、权限可控的原生集成方式完成。它不依赖钉钉群机器人那种简易通知机制,而是对接钉钉开放平台的 Stream 模式事件订阅 + 企业内应用能力,实现真正的“在钉钉里聊天→Octop 理解并执行→结果实时回传(含卡片、文件、流式文本)”。
下面分三步讲清楚关键操作:
创建钉钉企业内部应用并启用 Stream 机器人能力
- 登录 钉钉开放平台 → 应用开发 → 企业内部应用 → 创建应用
- 填写基础信息后,在「应用能力」中勾选并启用「机器人」能力
- 进入「机器人配置」页,消息接收模式必须选择
Stream(这是 Octop v0.9.20 支持流式响应和复杂交互的前提) - 记下生成的:
-
AppKey(即 Client ID) -
AppSecret(即 Client Secret) -
Webhook URL(用于后续验证,非传统单向 webhook)
-
配置 Octop 的 DingTalk Connector
- 启动 Octop 后,进入管理控制台(默认
http://localhost:3000或云部署对应地址) - 导航至 Settings → Connectors → Add Connector → DingTalk
- 填入上一步获取的:
- AppKey
- AppSecret
- 钉钉企业 CorpId(可在「企业信息」页找到)
- 开启「流式响应支持」和「群聊 @ 触发」选项(v0.9.20 默认支持)
- 点击「Test Connection」,显示 “Connected & Streaming Ready” 即表示通道握手成功
开通权限并发布应用
- 回到钉钉开放平台,进入该应用的「权限管理」
- 必须开通以下权限(缺一不可):
✅Card.Streaming.Write(用于发送带按钮/进度的流式卡片)
✅Card.Instance.Write(用于渲染结构化结果卡片)
✅qyapi_robot_sendmsg(基础消息发送)
✅contacts.read(如需读取成员信息做权限校验) - 进入「版本管理与发布」→「创建新版本」→ 提交审核(企业自建应用通常秒过)
- 发布成功后,在钉钉客户端搜索应用名,添加到目标群或个人工作台即可开始对话
注意:Octop v0.9.20 的钉钉通道默认启用「会话上下文隔离」和「组织架构权限继承」,意味着不同部门成员触发的指令,默认只能访问本部门可见的数据源,无需额外配置 RBAC。
不复杂但容易忽略。











