AI 助理
文档备案控制台
首页 轻量应用服务器 实践教程 最佳实践 部署OpenClaw（原Moltbot、Clawdbot） OpenClaw集成钉钉

OpenClaw集成钉钉

更新时间: 2026-03-20 19:27:41

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

重要

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

环境准备

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

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

步骤一、购买OpenClaw套餐

重要

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

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

    该应用镜像基于Alibaba Cloud Linux 3.2104 LTS 64位操作系统，来源于阿里云计算巢。

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

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

    • 地域：默认北京。

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

步骤二、配置OpenClaw

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

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

    重要

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

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

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

      Coding Plan 目前支持 qwen3.5-plus、kimi-k2.5、MiniMax-M2.5、glm-5等模型，详细的模型列表请参考Coding Plan概述。

    • 按Token用量计费的百炼API Key。

    API Key配置方式包括系统推荐及手动输入。系统推荐会列出百炼Coding Plan的API Key（成本可控），及离服务器最近的百炼模型服务的API Key（时延较低）。若需使用其他地域或者其他账号的API Key可选择手动输入。

    • 系统推荐（下拉选择）

      选择完成后单击下一步。

      轻量应用服务器所在地域

      系统推荐的百炼API Key对应地域

      Coding Plan的API key对应地域

      中国内地地域

      华北2（北京）

      华北2（北京）

      美国及欧洲地域

      美国（弗吉尼亚）

      中国香港及其他亚洲地域

      新加坡

    • 手动输入

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

      重要

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

  4. 单击访问Web UI面板下的获取地址，获取OpenClaw WebUI的地址，可以在Web页面与OpenClaw的Agent对话。

    可根据需求参考关闭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机器人信息，可根据业务需要修改配置后，单击确定进行创建。

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

    image.png

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

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

    image.png

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

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

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

    image

3. 测试机器人

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

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

群聊

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

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

    image

私聊

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

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

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

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

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

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

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

    image

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

    image

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

常见问题

如何重启OpenClaw网关？

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

image

如何更改OpenClaw调用的模型？

控制台切换

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

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

image

手动修改配置

  1. 在轻量应用服务器控制台-服务器页面，单击部署了OpenClaw的服务器卡片中的实例ID，进入服务器概览页面。

  2. 单击应用详情页签，在访问控制页面单击快速查看可进入Clawdbot对话页面。

  3. 单击Config > Agents，搜索Primary Model或Image Model，更改为百炼中支持的模型，填写格式为alibaba-cloud/模型Code，如alibaba-cloud/qwen3-max-2026-01-23，模型Code可以在百炼模型广场页面查询。

    image

钉钉机器人对话没有反应如何排查？

  1. 检查API Key配置是否正确：远程连接至轻量应用服务器中，将您配置的API Key及对应地域的Base URL替换进下方代码块，复制并粘贴至终端后测试模型调用。若返回报错信息，可在错误信息文档中搜索报错内容并根据方案处理。

    1. 不同地域的 Base URL 不通用

      1. 华北2（北京）： https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

      2. 美国（弗吉尼亚）： https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions

      3. 新加坡： https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions

      4. Coding Plan套餐：https://coding.dashscope.aliyuncs.com/v1

      curl -X POST YOUR_API_KEY_BASE_URL \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3-max-2026-01-23",
    "messages": [
        {
            "role": "user",
            "content": "你是谁？"
        }
    ]
}'

  2. 检查模型服务是否欠费或限流情况。

    1. Coding plan：套餐存在每 5 小时、每周、每月的限额请求次数，可以在Coding Plan 控制台查看套餐额度消耗情况。当超出限制时会报错hour/week/month allocated quota exceeded。

      解决办法：需等待额度自动恢复或升级至 Pro 套餐。

    2. 按Token计费的百炼API Key：

      1. 查看免费额度，登录后，在免费额度区域可查看到账户下该模型的剩余免费额度。

      2. 查看账号欠费，可以访问费用与成本中心，确保账户没有欠费。

若您的应用镜像为OpenClaw 2026.2.3及之前版本，或配置了AppFlow的连接流，还可按照以下步骤排查：

  1. 检查AppFlow连接流运行日志，第二个节点输出的text是不是为空，如果输出是空的，可能是OpenClaw不稳定，建议看看OpenClaw log进行分析或者重启下OpenClaw服务。

  2. 首先查看AppFlow菜单，执行日志，是否有日志，如果没有日志，那么常见原因是钉钉应用没有发布最新版本导致，需要在钉钉机器人控制台页面，创建新版本并发布。

    不仅要发布机器人，还需要发布钉钉应用。

    image.png

    image.png

  3. 检查消息接收地址URL是否正确。URL格式一定为https://xxxxx.appflow.aliyunnest.com/webhook/xxxxxxxxx。

    强烈建议自己拉群测试，不要使用钉钉提供的测试群进行测试。

    image.png

上一篇: 购买并部署OpenClaw应用镜像 下一篇: OpenClaw集成飞书