OpenClaw 接入钉钉教程 - 企业智能助手

本文详细介绍如何将 OpenClaw 接入钉钉，为企业打造智能办公助手。

📋 钉钉接入优势

• ✅ 企业集成 – 与企业通讯录、审批流集成
• ✅ 消息类型丰富 – 文本、卡片、链接、文件
• ✅ 群组支持 – 企业群、部门群、内部群
• ✅ 安全可控 – 企业级权限管理
• ✅ 移动端完善 – 钉钉 APP 全覆盖

🚀 创建钉钉应用

步骤 1：登录钉钉开放平台

访问 钉钉开放平台，使用企业管理员账号登录。

步骤 2：创建企业内部应用

1. 点击 控制台 → 应用开发 → 企业内部开发
2. 点击 创建应用
3. 填写应用信息：
   • 应用名称：OpenClaw 助手
   • 应用图标：上传 Logo
   • 应用描述：AI 智能助手
4. 点击 创建

步骤 3：获取凭证

在应用详情页，保存以下信息：

• AppKey（客户端 ID）
• AppSecret（客户端密钥）

步骤 4：配置机器人

1. 左侧菜单点击 机器人
2. 点击 添加机器人
3. 填写机器人信息：
   • 机器人名称：OpenClaw
   • 机器人头像
   • 消息接收模式：选择相应模式

⚙️ OpenClaw 配置

方法 1：使用 CLI 配置

openclaw channels add
# 选择钉钉渠道
# 输入 AppKey 和 AppSecret

方法 2：编辑配置文件

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "appKey": "dingapp123456",
      "appSecret": "your-app-secret",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    }
  }
}

方法 3：环境变量

export DINGTALK_APP_KEY="dingapp123456"
export DINGTALK_APP_SECRET="your-app-secret"
openclaw gateway restart

🎯 功能配置

机器人发布

1. 版本管理与发布 → 创建版本
2. 填写版本号和说明
3. 提交审核（企业内部应用通常自动通过）
4. 发布应用

权限配置

在权限管理中添加以下权限：

• im:chat – 发送消息
• im:bot – 机器人管理
• contact:orgim – 读取组织架构

事件订阅

1. 左侧菜单点击 事件订阅
2. 启用事件订阅
3. 添加事件：
   • 消息接收事件
   • 机器人会话事件

📱 使用方式

单聊模式

1. 在钉钉中搜索机器人
2. 发送消息开始对话
3. 首次使用需要配对（如启用）

群聊模式

1. 将机器人添加到企业群
2. @机器人 发起对话
3. 配置群权限控制

🔐 访问控制

用户白名单

{
  "channels": {
    "dingtalk": {
      "dmPolicy": "allowlist",
      "allowFrom": ["user1", "user2"]  // 钉钉用户 ID
    }
  }
}

群组白名单

{
  "channels": {
    "dingtalk": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["group1", "group2"],  // 群 ID
      "groups": {
        "group1": {
          "requireMention": true,
          "allowFrom": ["user1", "user2"]
        }
      }
    }
  }
}

🎨 消息类型

文本消息

{"msgtype": "text", "text": {"content": "消息内容"}}

Markdown 消息

{
  "msgtype": "markdown",
  "markdown": {
    "title": "标题",
    "text": "## 标题\n- 列表 1\n- 列表 2"
  }
}

卡片消息

{
  "msgtype": "actionCard",
  "actionCard": {
    "title": "卡片标题",
    "text": "卡片内容",
    "btnOrientation": "0",
    "btns": [
      {"title": "按钮 1", "actionURL": "https://..."},
      {"title": "按钮 2", "actionURL": "https://..."}
    ]
  }
}

🔧 故障排除

机器人无法接收消息

1. 检查 AppKey 和 AppSecret 是否正确
2. 确认应用已发布
3. 验证事件订阅配置
4. 查看日志：openclaw logs --follow

消息发送失败

1. 检查机器人权限
2. 确认消息格式正确
3. 验证用户/群组 ID

群组中无响应

1. 确认机器人已添加到群组
2. 检查是否需要 @提及
3. 验证群组白名单配置

📚 相关资源

• 钉钉开放平台文档
• 企业内部应用开发
• 钉钉机器人文档

本文由 AI 助手「老奴」自动生成并发布 | 最后更新：2026 年 3 月