连接钉钉机器人

连接钉钉 Stream 机器人#

创建企业机器人，把凭据填入 Onevium，再验证群消息进入项目助手。这里使用企业应用的 Stream 凭据，不是群自定义 Webhook 地址。

创建并发布机器人#

1. 打开钉钉开发者后台，创建企业内部应用。
2. 到应用能力 → 添加应用能力 → 机器人，填写名称、图标、描述和消息预览图。
3. 消息接收模式选择 Stream，发布/保存机器人。接收 URL 是 HTTP 模式的配置，本流程不用填写。
4. 发布应用，将测试用户纳入可用范围，把机器人加入测试群。
5. 在应用凭据中取得 Client ID / App Key 与 Client Secret / App Secret。

步骤依据钉钉机器人配置指南及官方 Stream SDK 说明。普通机器人消息通过 Stream 机器人回调接收，不需要另编一个事件订阅主题。

开通消息和卡片能力#

在应用的权限管理搜索下列准确能力名称，组织要求审批时先完成审批：

对应官方群消息接口、创建投放卡片、更新卡片及流式卡片指南。按功能配置即可，不需要把所有带“消息”“卡片”的权限全部勾选。

在 Onevium 注册连接#

打开渠道 → 新建渠道 → 单个机器人 → 钉钉，填写 App Key 和 App Secret，点击注册凭据。Stream 检查通过后继续配置。

回答选定演示项目的问题。
检查代码或文档时给出文件依据。
连接测试时，在当前会话记住测试代号。
不要仅为回答问题而修改文件。

保存后核对运行状态，停止时点击启动。平台提供“测试长连接”入口时，应在 Onevium 连接期间测试。简易表单用 App Key 作为机器人代码的回退值，没有单独的自定义卡片模板字段。

验证往返和上下文#

在测试群 @机器人：“测试代号 beta-27。”第二轮再 @它询问代号。核对两轮回复可读，并在 Onevium 找到对应会话。

需要私聊时，调整聊天范围、私聊策略；允许用户填写平台用户 ID，每行一个，不填显示名称。已有聊天另有聊天设置 → 会话模式，上下文意外共享时检查这里。

理解流式卡片#

Onevium 使用内置 AI 卡片模板，无需另建模板或填写模板 ID；机器人表单没有这个输入项。

遇到模板错误时保留平台错误和模板 ID，检查卡片权限，再确认是否收到可读的回退消息。组织无法使用内置模板时，应反馈版本兼容问题；创建另一个 ID 的模板不会改变客户端内置选择。文件、成员和群历史访问也应与文字回复分别开通和测试。

按现象排错#

下一步#

上下文共享见渠道设置，定期投递见自动化。其他平台可参考飞书接入。