MoltBot 对接钉钉 Stream 流式接入配置详解

前置说明

这次接入不需要额外的工作流支持，也无需开放外网权限，直接在本地或内网环境即可完成配置。

具体步骤

1. 准备依赖

首先确认一下官方提供的连接器代码：

https://github.com/DingTalk-Real-AI/dingtalk-moltbot-connector

2. 修改项目配置

在项目的 package.json 文件中增加如下配置，确保插件路径和通道正确：

{
  "moltbot": {
    "extensions": ["./plugin.ts"],
    "channels": ["dingtalk-connector"],
    "installDependencies": true
  }
}

3. 安装插件

执行安装命令拉取钉钉连接器：

moltbot plugins install dingtalk-moltbot-connector

4. 配置网关信息

接下来编辑 ~/.moltbot/moltbot.json 配置文件。如果文件已存在，直接修改对应字段即可。重点在于填入你的钉钉 AppKey 和 AppSecret：

{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "dingxxxxxxxxx",
      "clientSecret": "your_secret_here",
      "gatewayToken": "",
      "gatewayPassword": "",
      "sessionTimeout": 1800000
    }
  },
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    }
  }
}

注意：gatewayToken 和 gatewayPassword 二选一即可，通常来自 opencode.json 中的 gateway.auth.token 配置。会话超时默认 30 分钟（1800000ms），可按需调整。

5. 重启网关

配置完成后，记得重启网关服务以生效：

moltbot gateway restart

6. 钉钉平台设置

最后，登录钉钉开发者后台修改机器人配置：

• 切换模式为 Stream（流式）
• 关闭工作流功能

这样配置就完成了，后续就可以通过 Stream 方式接收实时消息了。