阿里云云部署OpenClaw集成钉钉

本文介绍将 OpenClaw服务与钉钉集成，实现在钉钉群聊或单聊中，通过自然语言直接与OpenClaw交互。

重要

OpenClaw 为开源 AI 助手，请在使用前充分评估其安全性与稳定性并严格遵循许可协议，以切实保障系统环境与数据安全。

环境准备

配置消息渠道前，需参考以下步骤或部署OpenClaw镜像文档购买并配置OpenClaw应用镜像的轻量应用服务器，若已完成可跳过此步骤。

购买并配置OpenClaw应用镜像的轻量应用服务器

集成钉钉

OpenClaw插件集成方式仅支持镜像版本为 OpenClaw 2026.2.9及以上的实例。如需在旧版本中集成该消息渠道，请参考通过AppFlow集成消息渠道。您可在轻量应用服务器概览页的 基本信息 > 镜像信息中查看当前实例的镜像版本。

1. 创建钉钉应用

1. 选择或创建组织。
   选择组织
   创建组织
   
   
   访问钉钉开放平台，登录时会出现如下提醒。请选择有开发者权限的组织，或者选择某个组织后，获取开发者权限。
   
   
2. 访问钉钉开放平台，在开发者后台，在一键自动创建OpenClaw机器人处点击立即创建。
   
3. 平台已自动预设OpenClaw机器人信息，可根据业务需要修改配置后，单击确定进行创建。

如需创建多个应用建议在创建时修改机器人名称或者图标，方便后续区分。

1. 在创建成功后，复制并保存应用的Client ID和Client Secret。

窗口关闭后仍可进入已创建的应用在左侧导航栏单击凭证与基础信息中查看Client ID和Client Secret。

2. 在轻量应用服务器控制台配置钉钉应用

1. 返回轻量应用服务器-控制台，单击配置了OpenClaw的服务器卡片中的实例ID，在服务器概览页面单击应用详情页签。
   
2. 在通道配置 > 钉钉中填入复制的钉钉应用的Client ID和Client Secret，并单击应用，等待命令执行成功。
   

3. 测试机器人

你可以创建群聊或在已有群聊中添加机器人，在钉钉群中@机器人进行对话，或通过搜索的方式与机器人私聊进行测试。

更改百炼模型请参考如何更改OpenClaw调用的模型。

群聊

私聊

1. 进入钉钉群群设置页面，点击机器人卡片区域，在机器人管理页面，点击添加机器人。在添加机器人的搜索文本框中输入目标机器人名称，并选中要添加的机器人。点击添加，完成后再点击完成添加。
   
2. 在钉钉群中@机器人进行交流互动。也可以在钉钉的搜索栏中，输入机器人名称后，在功能页检索到对应机器人，进行私聊互动。
   

4. 配置定时任务（可选）

配置机器人之后，可通过与OpenClaw对话创建定时任务，以创建一个定时查询实时天气的任务为例。

1. 获取机器人的Webhook地址：在已添加机器人的群聊中单击右上角群设置 > 群管理 > 机器人，单击机器人管理中的机器人头像，复制机器人的Webhook地址并粘贴。
   
   
2. 在OpenClaw对话中创建相应任务，格式为定时任务内容+群机器人的Webhook地址。
   
   
3. 验证消息发送。可在对话中让Agent立即发送消息，测试该定时任务。在机器人所在的群聊查看是否执行定时任务。若需修改或者取消定时任务，可直接在对话中让Agent修改或取消定时任务
   

如需使用AppFlow配置定时任务，请参考如何使用AppFlow配置定时任务。

常见问题

如何重启OpenClaw网关？

当遇到连接中断或服务不可用等场景时，可在控制台页面重启OpenClaw网关。在应用详情 > 基础配置 > 重启OpenClaw网关中单击执行命令。

如何更改OpenClaw调用的模型？

OpenClaw集成了阿里云百炼平台，在页面切换不同的模型。在应用详情 > 模型配置 > 模型配置中删除默认的模型，然后下拉选择不同的百炼模型。

支持手动输入模型名，模型Code可以在百炼模型广场页面查询。

如何绑定多个钉钉机器人到不同的Agent？

OpenClaw 基于 openclaw.json 的路由映射机制实现多角色隔离：通过 agents.list 定义多职能 Agent，在 channels.dingtalk-connector.accounts 配置独立钉钉机器人，最后由 bindings 确立钉钉机器人与 Agent 的映射关系，从而实现不同钉钉机器人提供专属 AI 角色的定向服务。

以两个钉钉机器人绑定到"客服"和"技术支持"的Agent为例。

前提条件

• 已完成OpenClaw应用镜像部署，且镜像版本为OpenClaw 2026.3.13及以上。
  
• 需在钉钉开放平台创建多个机器人并获取各自的Client ID和Client Secret，创建方法参考1创建钉钉应用。
  

操作步骤

1. 修改配置文件。将配置文件中的your_bot1_client_id、your_bot1_client_secret等占位值替换为钉钉开放平台获取的实际Client ID和Client Secret。
   重要
   agents.list.model.primary需替换为在OpenClaw中已配置的模型名称，本示例以百炼Coding Plan的dashscope-coding/qwen3.5-plus为例。
   

{
  "agents": {
    "list": [
      {
        "id": "ding-bot1",
        "name": "DingTalk Customer Service Bot",
        "model": {
          "primary": "dashscope-coding/qwen3.5-plus"
        },
        "workspace": "/home/admin/.openclaw/workspace-bot1",
        "identity": {
          "name": "Service Assistant",
          "theme": "Customer Service"
        }
      },
      {
        "id": "ding-bot2",
        "name": "DingTalk Tech Support Bot",
        "model": {
          "primary": "dashscope-coding/qwen3.5-plus"
        },
        "workspace": "/home/admin/.openclaw/workspace-bot2",
        "identity": {
          "name": "Tech Expert",
          "theme": "Tech Support"
        }
      }
    ]
  },
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "accounts": {
        "bot1": {
          "enabled": true,
          "clientId": "YOUR_BOT1_CLIENT_ID",
          "clientSecret": "YOUR_BOT1_CLIENT_SECRET"
        },
        "bot2": {
          "enabled": true,
          "clientId": "YOUR_BOT2_CLIENT_ID",
          "clientSecret": "YOUR_BOT2_CLIENT_SECRET"
        }
      },
      "separateSessionByConversation": true,
      "groupSessionScope": "group",
      "sharedMemoryAcrossConversations": false
    }
  },
  "bindings": [
    {
      "agentId": "ding-bot1",
      "match": {
        "channel": "dingtalk-connector",
        "accountId": "bot1"
      }
    },
    {
      "agentId": "ding-bot2",
      "match": {
        "channel": "dingtalk-connector",
        "accountId": "bot2"
      }
    }
  ]
}

1. 进入实例 Web UI 面板，向 OpenClaw 发送指令 修改OpenClaw配置文件，新增如下内容，修改好重启网关并追加上一步修改好的配置内容。
   
2. 验证效果。在钉钉中找到配置内容中的两个机器人，发送测试消息，确认各机器人能正常响应。