钉钉 | 302 AI Studio

一、获取钉钉凭证

1. 创建企业

不需要任何材料，手机、电脑端操作类似：

钉钉右上角点击「创建团队」

创建或加入企业按钮

选择「企业」
选择「创建企业/团队」
填写企业信息

企业信息表单

2. 登录开发者平台

访问钉钉开放平台，点击右上角头像切换到刚创建的企业。

切换企业

3. 创建应用

点击主页的「创建应用」：

创建应用按钮

应用类型选择

应用创建表单

填写应用信息后点击「发布」：

应用发布

4. 获取 `Client ID` 和 `Client Secret`

在应用详情页获取凭证，将 Client ID 和 Client Secret 同步更新到 302 AI Studio 配置中。

获取凭证

5. 发布版本

只有发布版本后，才能在钉钉中搜索到机器人。

创建版本

版本信息

版本发布

6. 启用 AI Card 流式输出（可选）

如需使用 AI Card 流式输出，需要在钉钉应用权限中开通：

Card.Instance.Write
Card.Streaming.Write

权限搜索

权限申请

如果未开启权限或不启用 AI Card，也不影响正常对话；系统会回退到普通消息，并在日志中给出权限申请指引链接。

二、配置与启动

1. 配置钉钉渠道

推荐使用「配置向导」：openclaw china setup

openclaw config set channels.dingtalk '{
  "enabled": true,
  "clientId": "dingxxxxxx",
  "clientSecret": "your-app-secret",
  "longTaskNoticeDelayMs": 30000,
  "enableAICard": true,
  "maxFileSizeMB": 100,
  "inboundMedia": {
    "dir": "~/.openclaw/media/dingtalk/inbound",
    "keepDays": 7
  }
}' --json

配置项说明：

配置项	类型	默认值	说明
enabled	boolean	true	是否启用钉钉渠道
defaultAccount	string	`"default"` / 首个账号	默认账户 ID
clientId	string	-	钉钉应用 AppKey
clientSecret	string	-	钉钉应用 AppSecret
dmPolicy	string	"open"	单聊策略: open/pairing/allowlist
groupPolicy	string	"open"	群聊策略: open/allowlist/disabled
longTaskNoticeDelayMs	number	30000	非流式普通消息模式下，首条正式回复超过该时长仍未发送时，自动补发提示消息；设为 `0` 可关闭
enableAICard	boolean	true	是否启用 AI Card 流式响应
maxFileSizeMB	number	100	媒体文件大小限制 (MB)
inboundMedia.dir	string	`~/.openclaw/media/dingtalk/inbound`	入站媒体归档根目录
inboundMedia.keepDays	number	7	入站媒体保留天数（按过期清理）

入站媒体保留策略：

先下载到临时目录，再归档到 inboundMedia.dir/YYYY-MM-DD/
每次消息处理结束后，按 keepDays 清理过期文件

2. 多账户配置

如需配置多个钉钉机器人，可以使用 accounts 对象（键为账户 ID）：

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "defaultAccount": "bot1",
      "groupPolicy": "open",
      "accounts": {
        "bot1": {
          "name": "主机器人",
          "clientId": "ding-main-app-key",
          "clientSecret": "ding-main-app-secret",
          "enableAICard": true
        },
        "bot2": {
          "name": "备用机器人",
          "clientId": "ding-backup-app-key",
          "clientSecret": "ding-backup-app-secret",
          "enableAICard": false
        }
      }
    }
  }
}

顶层配置作为默认值，账户内同名字段会覆盖顶层配置
defaultAccount 未设置时，优先使用 default，否则取排序后的首个账户
多 agent 分流时，可按 channel = "dingtalk" + accountId 编写 bindings

3. OpenClaw 初始化

openclaw onboard --install-daemon

如果已经执行了配置向导，那么可以在 channel 时选择忽略。

4. 启动服务

在 302 AI Studio 客户端的「设置 → Vibe 模式」中点击「更新配置」按钮，网关将自动重启，之后即可在钉钉中正常对话。

钉钉

目录