OpenClaw 钉钉机器人配置完整教程

本文详细介绍如何在 OpenClaw 中配置钉钉机器人，实现通过钉钉与 AI 助手交互。

一、前置条件

在开始配置前，你需要准备：

• 一个钉钉账号（需要企业/组织权限）
• 稳定的网络环境
• 已安装好的 OpenClaw

二、钉钉开发者后台创建应用

1. 登录开发者后台

打开 钉钉开发者后台，使用钉钉账号登录。

2. 创建应用

1. 进入「应用管理」→「应用开发」
2. 点击「创建应用」
3. 填写应用信息：
   • 应用名称：OpenClaw AI助手
   • 应用描述：个人 AI 助手
   • 应用图标：可上传自定义图标

3. 添加机器人能力

1. 在应用详情页面，点击「添加能力」
2. 选择「机器人」
3. 配置机器人信息：
   • 机器人名称：OpenClaw
   • 机器人头像：可自定义
   • 描述：你的个人 AI 助手

4. 配置消息接收模式

重要：选择「Stream 模式」：

1. 进入机器人配置页面
2. 找到「消息接收模式」
3. 选择 Stream 模式（推荐）
4. 配置回调地址：你的服务器地址/callback

5. 发布应用

1. 完成开发后，点击「发布」
2. 等待审核（如是企业内部应用通常即时通过）

三、获取凭证信息

发布成功后，获取以下信息：

四、OpenClaw 配置

方式一：交互式配置（推荐）

# 启动配置向导
openclaw configure

# 或直接配置渠道
openclaw configure --section channels

按照提示选择「钉钉」，输入凭证信息。

方式二：手动配置

编辑 OpenClaw 配置文件：

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "config": {
        "clientId": "你的AppKey",
        "clientSecret": "你的AppSecret",
        "corpId": "你的企业ID",
        "agentId": "你的应用ID",
        "robotCode": "你的RobotCode"
      }
    }
  }
}

方式三：使用 config patch

openclaw config patch --raw '{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "config": {
        "clientId": "你的AppKey",
        "clientSecret": "你的AppSecret",
        "corpId": "你的企业ID",
        "agentId": "你的应用ID",
        "robotCode": "你的RobotCode"
      }
    }
  }
}'

五、验证配置

1. 重启 Gateway

openclaw gateway restart

2. 检查状态

openclaw status

应该显示：

DingTalk: configured

3. 测试发送

# 发送测试消息
openclaw message send --channel dingtalk --target 你的用户ID --message "测试消息"

4. 测试接收

在钉钉中@你的机器人，发送消息，应该能收到回复。

六、常见问题

Q1: 消息发送成功但收不到回复？

检查：

1. 机器人是否已发布
2. Stream 模式是否正确配置
3. 回调地址是否可访问

Q2: 配置显示 “Account not configured”

确保配置文件路径正确，尝试重启 Gateway。

Q3: 消息延迟或丢失

可能是网络问题，检查服务器网络稳定性。

Q4: 如何更新凭证？

直接修改配置文件后重启 Gateway 即可。

七、高级配置

1. 群聊配置

让机器人在群聊中工作：

1. 在钉钉中创建群聊
2. 添加机器人到群聊
3. 在 OpenClaw 中配置群聊ID

2. 关键词回复

配置自动回复关键词：

{
  "channels": {
    "dingtalk": {
      "keywords": {
        "天气": "我来帮你查天气",
        "新闻": "我来帮你查新闻"
      }
    }
  }
}

3. 定时推送

设置定时任务推送消息：

openclaw cron add \
  --name "每日早报" \
  --cron "0 7 * * *" \
  --message "早安！今天是..." \
  --channel dingtalk \
  --announce

八、安全建议

1. 保护凭证：不要将 AppSecret 泄露到公开代码库
2. 定期更换：定期更新应用密钥
3. 限制权限：只授权必要的接口权限
4. 日志监控：定期检查消息日志

九、完整配置示例

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "config": {
        "clientId": "dingxxxxx",
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx",
        "corpId": "dingxxxxx",
        "agentId": "1234567890",
        "robotCode": "dingxxxxx"
      },
      "options": {
        "autoReply": true,
        "mentionOnly": false
      }
    }
  }
}

十、相关命令速查

总结

配置钉钉机器人需要以下步骤：

1. 在钉钉开发者后台创建应用并发布
2. 获取凭证信息（AppKey、AppSecret 等）
3. 在 OpenClaw 中配置钉钉渠道
4. 重启 Gateway 并验证

按照本文档操作，通常 5-10 分钟即可完成配置。

如果有问题，欢迎在评论区留言讨论！