本文介紹如何通過DingTalk應用與機器人接入OpenClaw,實現使用者與機器人對話,驅動OpenClaw完成相關任務。
方案概述
通過DingTalk應用與機器人,實現使用者與機器人對話,驅動OpenClaw完成相關任務。接入主要經過以下步驟:
建立DingTalk應用並與雲電腦系統OpenClaw進行安全憑證對接。
建立DingTalk機器人。
建立卡片模板。
發布DingTalk應用。
使用DingTalk機器人。
建立DingTalk應用
前往DingTalk開放平台。
說明需選擇具備開發人員許可權的組織,或者選擇某個組織後選擇擷取開發人員許可權。
如果沒有合適的組織,可使用移動端DingTalk掃描下方二維碼,快速建立一個組織。

點擊頂部導覽列應用開發,在DingTalk應用頁面點擊建立應用。
選擇左側導覽列的憑證與基礎資訊,查看並複製Client ID 以及Client Secret。
返回雲電腦OpenClaw Config頁面,選擇通道設定。
開啟DingTalk卡片右側開關,將複製的Client ID和Client Secret分別填入App Key及App Secret中。
填寫完畢後點擊右上方儲存。
建立DingTalk機器人
應用建立完畢後在左側導覽列選擇添加應用能力,點擊右側機器人卡片下方添加按鈕。
在機器人配置頁面,開啟機器人配置。
訊息接收模式選擇Stream模式,並點擊發布完成對機器人的配置。
選擇左側導覽列的版本管理與發布,並點擊建立新版本。
完成配置後點擊下方的儲存完成版本的發布。
建立訊息卡片
DingTalk機器人通過卡片訊息支援流式返回結果,需要建立卡片模板供訊息發送使用。
前往卡片平台,點擊建立模板。
在建立模板輸入框,根據以下資訊建立模板。
卡片類型:選擇訊息卡片。
卡片模板情境:選擇AI卡片。
關聯應用:填入先前步驟建立的應用程式名稱。
在卡片編輯頁面右上方點擊儲存,然後單擊發布。
發布應用
應用發布後,企業員工方可搜尋並使用。
返回應用列表,選擇目標應用,進入目標詳情頁。
在許可權管理中開通
Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg三個許可權。在左側菜單中選中版本管理與發布,並點擊建立新版本。
在版本詳情中,填寫應用版本號碼和版本描述,並選擇應用的可用範圍,最後單擊儲存即可。
說明在選擇應用可用範圍時,請根據業務實際需求選擇可見範圍,若選擇全部員工,則當應用發布後當前企業下所有的員工都可見。
與DingTalk機器人對話
在群聊中與機器人對話
開啟DingTalk用戶端,進入任意群聊。
如果已有群聊,需要確保群歸屬組織與建立機器人時的組織相同。
建立新的群聊,請確保建立時候選擇的歸屬組織與建立機器人時的組織相同。
單擊群設定(右上方),進入群設定,然後選擇機器人。
在機器人管理模組下,選擇添加機器人。
在添加機器人介面,通過搜尋已經建立並發布的機器人,點擊機器人進行添加即可。
機器人添加成功後,通過@機器人,實現自動回複。
與機器人直接對話
在DingTalk頂部搜尋方塊中搜尋已建立機器人名稱直接使用。
發送訊息與機器人進行單獨對話。
常見問題
DingTalk機器人配置後無法收到訊息
檢查 Client ID 和 Client Secret 配置是否正確。
確認已申請
Card.Streaming.Write、Card.Instance.Write和qyapi_robot_sendmsg許可權。檢查機器人訊息接收地址是否正確配置。
確保應用版本發行。
群添加機器人時找不到建立的機器人
原因可能是:
該群聊的歸屬組織與建立機器人時的組織不同。請選擇或重新建立一個正確的群聊。
群聊歸屬組織正確,但不是內部群,需轉換為內部群。