全部產品
Search
文件中心

:DingTalk接入

更新時間:Mar 25, 2026

本文介紹如何通過DingTalk應用與機器人接入OpenClaw,實現使用者與機器人對話,驅動OpenClaw完成相關任務。

方案概述

通過DingTalk應用與機器人,實現使用者與機器人對話,驅動OpenClaw完成相關任務。接入主要經過以下步驟:

  • 建立DingTalk應用並與雲電腦系統OpenClaw進行安全憑證對接。

  • 建立DingTalk機器人。

  • 建立卡片模板。

  • 發布DingTalk應用。

  • 使用DingTalk機器人。

建立DingTalk應用

  1. 前往DingTalk開放平台

    說明
    • 需選擇具備開發人員許可權的組織,或者選擇某個組織後選擇擷取開發人員許可權

    • 如果沒有合適的組織,可使用移動端DingTalk掃描下方二維碼,快速建立一個組織。image

  2. 點擊頂部導覽列應用開發,在DingTalk應用頁面點擊建立應用

  3. 選擇左側導覽列的憑證與基礎資訊,查看並複製Client ID 以及Client Secret

  4. 返回雲電腦OpenClaw Config頁面選擇通道設定

  5. 開啟DingTalk卡片右側開關,將複製的Client IDClient Secret分別填入App KeyApp Secret中。

  6. 填寫完畢後點擊右上方儲存

建立DingTalk機器人

  1. 應用建立完畢後在左側導覽列選擇添加應用能力,點擊右側機器人卡片下方添加按鈕。

  2. 在機器人配置頁面,開啟機器人配置

  3. 訊息接收模式選擇Stream模式,並點擊發布完成對機器人的配置。

  4. 選擇左側導覽列的版本管理與發布,並點擊建立新版本

  5. 完成配置後點擊下方的儲存完成版本的發布。

建立訊息卡片

DingTalk機器人通過卡片訊息支援流式返回結果,需要建立卡片模板供訊息發送使用。

  1. 前往卡片平台,點擊建立模板

  2. 在建立模板輸入框,根據以下資訊建立模板。

    • 卡片類型:選擇訊息卡片

    • 卡片模板情境:選擇AI卡片

    • 關聯應用:填入先前步驟建立的應用程式名稱。

  3. 在卡片編輯頁面右上方點擊儲存,然後單擊發布

發布應用

應用發布後,企業員工方可搜尋並使用。

  1. 返回應用列表,選擇目標應用,進入目標詳情頁。

  2. 許可權管理中開通Card.Streaming.WriteCard.Instance.Writeqyapi_robot_sendmsg三個許可權。

  3. 在左側菜單中選中版本管理與發布,並點擊建立新版本

  4. 在版本詳情中,填寫應用版本號碼版本描述,並選擇應用的可用範圍,最後單擊儲存即可。

    說明

    在選擇應用可用範圍時,請根據業務實際需求選擇可見範圍,若選擇全部員工,則當應用發布後當前企業下所有的員工都可見。

與DingTalk機器人對話

在群聊中與機器人對話

  1. 開啟DingTalk用戶端,進入任意群聊。

    • 如果已有群聊,需要確保群歸屬組織與建立機器人時的組織相同。

    • 建立新的群聊,請確保建立時候選擇的歸屬組織與建立機器人時的組織相同。

  2. 單擊群設定(右上方),進入群設定,然後選擇機器人

  3. 在機器人管理模組下,選擇添加機器人

  4. 在添加機器人介面,通過搜尋已經建立並發布的機器人,點擊機器人進行添加即可。

  5. 機器人添加成功後,通過@機器人,實現自動回複。

與機器人直接對話

  1. 在DingTalk頂部搜尋方塊中搜尋已建立機器人名稱直接使用。

  2. 發送訊息與機器人進行單獨對話。

常見問題

DingTalk機器人配置後無法收到訊息

  • 檢查 Client ID 和 Client Secret 配置是否正確。

  • 確認已申請 Card.Streaming.WriteCard.Instance.Writeqyapi_robot_sendmsg許可權。

  • 檢查機器人訊息接收地址是否正確配置。

  • 確保應用版本發行。

群添加機器人時找不到建立的機器人

原因可能是:

  • 該群聊的歸屬組織與建立機器人時的組織不同。請選擇或重新建立一個正確的群聊。

  • 群聊歸屬組織正確,但不是內部群,需轉換為內部群。