OpenClaw集成钉钉

更新时间:
复制为 MD 格式

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

重要

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

环境准备

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

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

步骤一、购买OpenClaw套餐

重要

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

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

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

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

    • 地域:默认北京

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

步骤二、配置OpenClaw

  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对应地域

      Coding PlanAPI key对应地域

      中国内地地域

      华北2(北京)

      华北2(北京)

      美国及欧洲地域

      美国(弗吉尼亚)

      中国香港及其他亚洲地域

      新加坡

    • 手动输入

      单击按钮切换至手动输入,输入百炼API Key并选择该API Key对应地域,单击下一步image

      重要

      手动配置需确保选择的API Key对应地域正确,否则会导致模型无法正常调用。

  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

    创建组织

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

    image

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

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

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

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

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

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

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

3. 测试机器人

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

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

群聊

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

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

私聊

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

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

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

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

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

    Screenshot_2026-03-03-10-53-22-00_6483dd1576f1330fe7c408604fe48ee1

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

    image

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

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

常见问题

如何重启OpenClaw网关?

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

image

如何更改OpenClaw调用的模型?

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

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

image

如何绑定多个钉钉机器人到不同的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. 验证效果。在钉钉中找到配置内容中的两个机器人,发送测试消息,确认各机器人能正常响应。