📋 前提条件

已完成 OpenClaw 服务部署
有钉钉账号,且有创建应用的权限(需管理员权限)
💡 如果还没有部署 OpenClaw,请先参考 云服务器部署教程 完成部署。

一、申请钉钉应用

1

访问钉钉开发者平台

前往钉钉开发者平台:https://open-dev.dingtalk.com

点击「创建应用

点击创建应用
2

选择机器人

选择「机器人」类型

选择机器人
3

填写应用信息

完成所有必填项(其他保持默认即可)

填写应用信息
4

获取凭证

点击「凭证与基础信息」,保存好 Client IDClient Secret,后面会用到

获取Client ID和Client Secret
5

发布应用

点击「查看版本详情」→「编辑

查看版本详情

完成所有必填项后点击「保存」,在弹出的窗口点击「确认发布

编辑版本信息
确认发布
💡
不想自己配?

专业团队帮你搞定从部署到钉钉接入的全部配置。

了解付费搭建服务 →

二、配置钉钉频道

在 OpenClaw 中配置钉钉凭证,有两种方式可选:

方式一:通过管理页面配置(推荐)

  1. 打开 OpenClaw 管理页面(默认 http://127.0.0.1:18789
  2. 点击左侧菜单「Channels
  3. 找到「DingTalk」,点击配置
  4. 填入 Client IDClient Secret
  5. 点击「Save」保存
💡 如果是云服务器,可以通过 SSH 隧道访问管理页面:ssh -L 18789:127.0.0.1:18789 用户名@服务器IP

方式二:通过命令行配置

client-idclient-secret 替换成自己的:

openclaw config set 'channels.dingtalk' '{
  "enabled": true,
  "clientId": "your-dingtalk-client-id",
  "clientSecret": "your-dingtalk-client-secret"
}'

配置完成后,启动或重启 Gateway:

nohup openclaw gateway --port 18789 --verbose &

查看日志确认启动成功:

cat nohup.out

三、验证

1

搜索机器人

在钉钉中搜索刚刚创建的 Bot

搜索机器人
2

发送消息测试

测试成功

部署成功! 🎉

❓ 常见问题

Q: 机器人收不到消息?

检查:

  1. 应用是否已发布(不是草稿状态)
  2. Client ID 和 Client Secret 是否正确
  3. Gateway 是否正常运行

Q: 需要配置回调地址吗?

不需要!钉钉使用 Stream 模式(长连接),无需公网 IP 和回调地址。

📚 更多资源