OpenClaw集成钉钉

更新时间:
复制为 MD 格式

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

重要

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

环境准备

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

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

步骤一、购买OpenClaw套餐

重要

如果已购买轻量应用服务器,可以跳过此步骤,以重置系统的方式部署OpenClaw(重置系统时选择应用镜像下的OpenClaw镜像),但重置系统会清除轻量应用服务器上的系统盘数据,请根据需要做好数据备份。具体操作,请参见重置系统

  1. 购买预装OpenClaw应用的轻量应用服务器

  2. 轻量应用服务器页面,预置了资源配置,如要更改配置项,请参考下面内容。

    • 实例:内存必须2GiB及以上,可以根据自己的需求切换套餐。

    • 地域:默认北京

    • 购买配置:默认12个月,可以根据自己的需求切换时长。

步骤二、配置OpenClaw

OpenClaw 提供两种配置方式,请根据您的镜像版本切换以下页签查看对应的操作步骤。

OpenClaw 2026.5.19 及以上版本(推荐)

  1. 登录轻量应用服务器控制台,单击服务器卡片中的实例 ID,在服务器概览页面单击应用详情页签。

  2. 在应用详情页左下角单击初始化按钮,根据弹出的初始化向导完成步骤 1:模型配置

    • 大模型平台:从下拉框中选择模型厂商,支持阿里云百炼 Token Plan(团队版)、阿里云百炼 Coding Plan、阿里云百炼、deepseek、Kimi、GLM Coding Plan、智谱等多家厂商。

    • API Key:选择 API Key 对应的地域,并填入 API Key。

    • 模型:选择或手动输入模型名。

    配置完成后单击立即配置进入下一步。

  3. 在初始化向导步骤 2:使用 Web UI中,需要先在放通 OpenClaw 访问端口区域单击确定放通完成端口放通,然后单击登录 Web UI即可跳转到 OpenClaw WebUI,与 OpenClaw 的 Agent 对话。

    重要

    端口放通将使服务暴露于公网。初始化完成后,可在应用详情页顶部状态栏的公网访问开关一键关闭,详见如何开启/关闭OpenClaw WebUI的公网访问

  4. (可选)查看 Token。初始化完成后,在应用详情页顶部状态栏的Token字段单击复制按钮即可获取完整 Token。

    警告

    请勿泄露包含 Token 的完整 URL。该链接包含身份验证凭据,任何持有此链接的人都能直接绕过登录验证,获得 OpenClaw 控制台的管理员权限。

OpenClaw 2026.5.19 之前版本

  1. 轻量应用服务器-控制台,单击服务器卡片中的实例ID,在服务器概览页面单击应用详情页签。

  2. OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw服务运行端口的防火墙。

    重要
  3. 单击配置OpenClaw下的执行命令配置百炼API key。

    目前支持配置两种类型的百炼API Key:

    • Coding Plan 套餐专属 API Key(推荐):采用固定月费模式,提供月度请求额度,超出时段限额的调用会报错且不计费用,可避免产生超出预期的费用。

      Coding Plan 目前支持 qwen3.5-pluskimi-k2.5MiniMax-M2.5glm-5等模型,详细的模型列表请参考Coding Plan概述
    • Token用量计费的百炼API Key。

    配置API Key。在下拉框中选择Coding PlanAPI Key或直接输入按量计费的API Key,选择模型后单击下一步

    手动输入API Key时,需确保所选地域与API Key对应的地域一致,否则会导致模型无法正常调用。
    重要

    初始化过程中暂不支持配置百炼 Token Plan,强行输入会导致报错。如需使用 Token Plan,请先完成初始化,再参见如何在 OpenClaw 中接入百炼 Token Plan 团队版?进行配置。

  4. 单击访问Web UI面板下的执行命令,获取OpenClaw WebUI的地址,可以在Web页面与OpenClawAgent对话。

    可根据需求参考关闭OpenClaw WebUI的公网访问一键关闭WebUI的公网访问权限。
  5. (可选)查看Token。

    应用详情 > 基础配置 > 查看Token中单击查看,查看并保存Token。

    警告

    请勿泄露包含 Token 的完整 URL。该链接包含身份验证凭据,任何持有此链接的人都能直接绕过登录验证,获得 OpenClaw 控制台的管理员权限。

集成钉钉

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

1. 创建钉钉应用

  1. 选择或创建组织。

    选择组织

    访问钉钉开放平台,登录时会出现如下提醒。请选择有开发者权限的组织,或者选择某个组织后,获取开发者权限

    创建组织

    若无可用组织,请使用钉钉移动端钉钉扫描下方二维码,会跳转至创建组织页面创建一个新组织。

    image

    钉钉移动客户端版本需≥6.5.45。
  2. 访问钉钉开放平台,在开发者后台,在一键自动创建OpenClaw机器人处点击立即创建。

  3. 平台已自动预设OpenClaw机器人信息,可根据业务需要修改配置后,单击确定进行创建。

    如需创建多个应用建议在创建时修改机器人名称或者图标,方便后续区分。
  4. 在创建成功后,复制并保存应用的Client IDClient Secret。

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

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

请根据您的镜像版本切换以下页签查看对应的操作步骤。

OpenClaw 2026.5.19 及以上版本(推荐)

  1. 登录轻量应用服务器控制台,找到目标 OpenClaw 服务器,进入应用详情页签。

  2. 通道 (Channels)卡片中,单击添加通道

  3. 在通道下拉框中选择 钉钉

  4. 保持默认选中的手动输入页签,填入复制的钉钉应用的Client IDClient Secret,单击应用,等待命令执行成功。

OpenClaw 2026.5.19 之前版本

  1. 返回轻量应用服务器-控制台,单击配置了OpenClaw的服务器卡片中的实例ID,在服务器概览页面单击应用详情页签。

  2. 通道配置 > 钉钉中填入复制的钉钉应用的Client IDClient Secret,并单击应用,等待命令执行成功。

3. 测试机器人

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

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

群聊

  1. 进入钉钉群群设置页面,点击机器人卡片区域,在机器人管理页面,点击添加机器人。在添加机器搜索文本框中输入目标机器人名称,并选中要添加的机器人。点击添加,完成后再点击完成添加

  2. 在钉钉群中@机器人进行交流互动。也可以在钉钉的搜索栏中,输入机器人名称后,在功能页检索到对应机器人,进行私聊互动。

私聊

  1. 在钉钉上方搜索框中搜索创建的机器人名称,并单击机器人的头像进行私聊。

  2. 进入私聊页面后,直接与机器人对话即可。

4. 配置定时任务(可选)

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

  1. 获取机器人的Webhook地址:在已添加机器人的群聊中单击右上角群设置 > 群管理 > 机器人,单击机器人管理中的机器人头像,复制机器人的Webhook地址并粘贴。

    Webhook 地址格式为 https://oapi.dingtalk.com/robot/send?access_token=xxx,单击 复制 按钮获取完整地址。

  2. OpenClaw对话中创建相应任务,格式为定时任务内容+群机器人的Webhook地址。

    例如输入:每天早上9点查询北京天气,Webhook地址为https://oapi.dingtalk.com/robot/send?access_token=xxx

  3. 验证消息发送。可在对话中让Agent立即发送消息,测试该定时任务。在机器人所在的群聊查看是否执行定时任务。若需修改或者取消定时任务,可直接在对话中让Agent修改或取消定时任务

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

常见问题

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

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

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

前提条件

  • 已完成OpenClaw应用镜像部署,且镜像版本为OpenClaw 2026.3.13及以上。

  • 需在钉钉开放平台创建多个机器人并获取各自的Client IDClient Secret,创建方法参考1创建钉钉应用

操作步骤

  1. 修改配置文件。将配置文件中的your_bot1_client_idyour_bot1_client_secret等占位值替换为钉钉开放平台获取的实际Client IDClient Secret。

    重要

    agents.list.model.primary需替换为在OpenClaw中已配置的模型名称,本示例以百炼Coding Plandashscope-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"
          }
        }
      ]
    }
  2. 进入实例 Web UI 面板,向 OpenClaw 发送指令 修改OpenClaw配置文件,新增如下内容,修改好重启网关并追加上一步修改好的配置内容。

  3. 验证效果。在钉钉中找到配置内容中的两个机器人,发送测试消息,确认各机器人能正常响应。