🔥玩转OpenClaw｜云上OpenClaw快速接入钉钉指南

> 💡 如果此时此刻您还不了解OpenClaw，或是了解但还没有开始部署OpenClaw，建议您先参考[云上OpenClaw(原Clawdbot)一键秒级部署指南](https://cloud.tencent.com/developer/article/2624003)来完成OpenClaw接入钉钉之前的部署操作。 > > 本文主要介绍如何在腾讯云轻量应用服务器Lighthouse中部署完成OpenClaw后，接入钉钉机器人。 # 前置准备工作 在正式开始为OpenClaw（原名Clawdbot，中文名俗称“龙虾”）配置接入钉钉机器人之前，请依次检查如下事项是否准备完成： - 您已经拥有一个具有企业管理员权限的钉钉账号（点击前往[钉钉开发者平台](https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app)）。 - 是否已经在轻量应用服务器Lighthouse实例中部署了OpenClaw，如果暂时还没有，建议： - 如果您希望新购一台[Lighthouse](https://cloud.tencent.com/product/lighthouse?from_column=20421&from=20421)服务器来安装运行OpenClaw，可以前往腾讯云Lighthouse产品的[购买页](https://buy.cloud.tencent.com/lighthouse)选购，或者前往腾讯云[OpenClaw专属活动](https://cloud.tencent.com/act/pro/lighthouse-moltbot)进行优惠下单。详细的部署和配置OpenClaw流程可参考[云上OpenClaw(原Clawdbot)一键秒级部署指南](https://cloud.tencent.com/developer/article/2624003)。 - 如果您使用OpenClaw应用模板创建Lighthouse服务器的<span style="color:rgb(51, 51, 51)">**时间早于2026年2月11日**</span><span style="color:rgb(51, 51, 51)">，建议参考教程更新版本</span>：[如何更新服务器OpenClaw应用版本](https://cloud.tencent.com/developer/article/2627964)。 > 提示：云上OpenClaw接入钉钉场景推荐使用国内的服务器和模型服务。 # 接入钉钉 > 💡 注意：以下步骤针对已在轻量应用服务器中部署OpenClaw，从零开始配置接入钉钉的情况，如果有部分步骤已完成，可酌情跳过。 ## 配置钉钉应用 ### 创建钉钉应用 前往[钉钉开发者平台](https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app)，使用具有管理员权限的账号登录平台。 在钉钉开发者平台进入“应用开发-钉钉应用”管理页面，点击**创建应用**，填写“应用名称”和“应用描述”。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/9efa39874fdced1f0c4b9d2f7b9b90bf.png" style="width:1072px;display:block;margin:0 auto" /> ### 添加机器人 选择上一步中创建的应用，为应用添加能力，选择**机器人**，点击**添加**。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/fb57cd8249a7fa91d487169df3c62e1a.png" style="width:1100px;display:block;margin:0 auto" /> ### 配置机器人 在“机器人配置”页面，填写所有的必填项，其他可选项保留默认值即可，随后点击**发布**。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/1cd5f0ff09f95bbc6be6e5ec011dbf96.png" style="width:1024px;display:block;margin:0 auto" /> 点击页面上方的**查看版本详情**，点击**编辑**图标开始进行编辑。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/ebc680309302c8c63e4bb67e82252191.png" style="width:1100px;display:block;margin:0 auto" /> 完成所有必填项，另外在“应用可见范围（可选项）”中可以配置能添加这个钉钉机器人的员工范围。<span style="color:rgb(0, 0, 0)">点击</span>**保存**<span style="color:rgb(0, 0, 0)">，</span>在弹出的窗口点击**确认发布**。发布后版本详情将显示“已上线”。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/39020b1132893d219bf4aada0631ced7.png" style="width:1072px;display:block;margin:0 auto" /> <img src="https://developer.qcloudimg.com/http-save/audit-8307438/43aeb819a74ea02b880e359ad5840bae.png" style="width:548px;display:block;margin:0 auto" /> ### 查询Client ID与Client Secret 进入“凭证与基础信息”页面，找到**Client ID与Client Secret**两个参数，复制后将其保存到个人记事本或备忘录中（注意数据安全，勿泄露），后续步骤中需要使用。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/5a0856cdbd903e9dcf319b4e4c3c1e51.png" style="width:1100px;display:block;margin:0 auto" /> ## 配置模型和通道 接下来需要为已经完成部署的OpenClaw配置模型和通道（即OpenClaw channel，如钉钉）。 ### 进入腾讯云控制台 <span style="color:rgb(0, 0, 0)">进入腾讯云</span>[控制台](https://console.cloud.tencent.com/lighthouse)<span style="color:rgb(0, 0, 0)">，选中对应的已部署OpenClaw的Lighthouse服务器实例，点击服务器卡片进入“管理实例”页；</span> <img src="https://developer.qcloudimg.com/http-save/audit-8307438/4755bd5d09d20988077bf63e9d322bb6.png" style="width:729px;display:block;margin:0 auto" /> ### 进入应用管理 进入腾讯轻量云Lighthouse应用管理页的配置面板； <img src="https://developer.qcloudimg.com/http-save/audit-8307438/b1cfbbc74f54eaa38c0e650dc877442e.png" style="width:1100px;display:block;margin:0 auto" /> ### **模型配置** 为OpenClaw配置模型API Key可以在轻量应用服务器Lighthouse产品[控制台](https://console.cloud.tencent.com/lighthouse)的应用管理页面进行操作。详情可参考教程“[云上OpenClaw(原Clawdbot)一键秒级部署指南](https://cloud.tencent.com/developer/article/2624003)-配置模型API Key”，此处不再赘述。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/c9a485cfb37cb5888ce9805853225502.png" style="width:1100px;display:block;margin:0 auto" /> > 【实用技巧】验证模型配置是否生效如果您担心模型配置未生效，可以登录轻量应用服务器并通过OpenClaw TUI工具进行验证。具体步骤可以参考教程“[云上OpenClaw(原Clawdbot)一键秒级部署指南](https://cloud.tencent.com/developer/article/2624003)-使用TUI与OpenClaw进行交互”。 ### **通道配置（配置钉钉机器人Client ID与Client Secret）** <span style="color:rgb(0, 0, 0)">进入</span>“应用管理”页签，在“通道配置”输入框，选择“钉钉”，并输入在前面步骤中获取的**Client ID与Client Secret**，点击**添加并应用**按钮，随后确定操作，<span style="color:rgb(0, 0, 0)">等待几秒后页面提示“保存成功”即完成配置，此时钉钉通道会显示“运行中”。</span> > 💡 提示：OpenClaw支持同一台服务器配置多个通道，例如支持同时接入钉钉机器人和飞书机器人。因此，如果当前正在配置的服务器之前已经接入了其他通道，也可以继续添加通道。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/774157afc8cdde075ea2371e58c92e22.png" style="width:1100px;display:block;margin:0 auto" /> 模型配置和通道配置都完成之后就初步完成了OpenClaw配置，继续后续步骤。 ## 与钉钉机器人互动 为OpenClaw配置钉钉机器人的**Client ID与Client Secret**之后，您可以在钉钉软件中尝试和已经打通OpenClaw的钉钉机器人进行单独聊天，或者将钉钉机器人添加进群聊。 #### **私聊场景** 首先在钉钉软件的搜索框中，输入前面步骤中创建的钉钉机器人的“应用名称”，添加之后即可开始对话。如果钉钉机器人能够以AI的方式对话，则说明您已经成功完成OpenClaw应用接入钉钉机器人。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/88d718e81342db47703d88a8efb5dda0.png" style="width:437px;display:block;margin:0 auto" /> #### **群聊场景** 以桌面版钉钉软件为示例，选择某个群聊（目前支持钉钉内部群和外部群），点击对话框右上角“群设置”按钮。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/c71dae61c471ed895d0355e9314a2597.png" style="width:424px;display:block;margin:0 auto" /> 点击**机器人**选项，再点击**添加机器人**。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/ca692e85b6941a935fb13a3f1391418e.png" style="width:1100px;display:block;margin:0 auto" /> 在搜索框中输入之前步骤创建的钉钉机器人名称，点击**添加**机器人，将钉钉机器人添加进群。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/c3f2b73b6cdbf4b4396612e767cf1ddb.png" style="width:390px;display:block;margin:0 auto" /> 钉钉机器人成功进群后，群里成员可通过“@机器人”的方式与其进行对话。正常情况下，钉钉机器人能够以AI的方式在群聊中进行对话。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/c5746f201804d269432c430c79f3d166.png" style="width:395px;display:block;margin:0 auto" /> # 支持的消息类型 基于前述步骤将OpenClaw接入钉钉后，钉钉机器人除了能够接收、回复基础的文本信息外，还支持更多消息类型，详情如下表所示： | **钉钉机器人支持功能** | **是否支持** | | --- | --- | | 接收文本消息 | ✅ 已支持 | | 接收语音消息 | ✅ 已支持 | | 接收图片 | ✅ 已支持 | | 接收文件 | ✅ 已支持 | | 回复文本消息 | ✅ 已支持 | | 回复图片 | ✅ 已支持 | | 回复文件 | ✅ 已支持 | | 回复内容支持Markdown格式 | ✅ 已支持 | | 主动发送消息（如定时发送提醒） | ✅ 已支持 | | 历史消息引用 | 🚧 即将支持 | > 💡 提示：上述表格仅代表钉钉机器人能接收/回复的消息类型，实际能否完成处理图片、文件等任务，还需要接入的模型具备相应的处理能力。 钉钉机器人可以接收图片、文件、语音消息，示例如下： > 提示：此处钉钉仅作为接收/回复信息的通道，实际能否完成任务会受到模型能力限制。例如您需要为OpenClaw配置支持理解分析图片的模型，才能让OpenClaw通过钉钉机器人接收图片并且进行分析。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/335fb047d1e83182fa93719e5e19a2eb.png" style="width:426px;display:block;margin:0 auto" /> <img src="https://developer.qcloudimg.com/http-save/audit-8307438/630eccf7b84d1c6005b23c2ef0ebec9f.png" style="width:434px;display:block;margin:0 auto" /> 钉钉机器人可以回复图片、文件，示例如下： > 提示：钉钉仅作为接收/回复信息的通道，实际能否完成任务会受到模型能力限制。例如您需要为OpenClaw配置支持生成图片的模型，才能让OpenClaw生成图片并通过钉钉机器人发送图片。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/0822b4944c9bcf7d0e78a8a5c7b4a819.png" style="width:462px;display:block;margin:0 auto" /> # 更多教程 更多云上OpenClaw实践教程，如一键部署OpenClaw、接入QQ/企微/钉钉/飞书/Discord/Telegram/WhatsApp、安装并使用Skills等，欢迎查看[云上OpenClaw(原Clawdbot)最全实践教程合辑](https://cloud.tencent.com/developer/article/2624973)。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/267244d75537fe100e9b56f888379c0a.png" style="width:676px;display:block;margin:0 auto" /> # 加入交流群 欢迎扫码加入OpenClaw交流群，和大家共同解锁、交流、探讨OpenClaw的各类实用、有趣玩法。 <img src="https://developer.qcloudimg.com/http-save/audit-8307438/b5eb9991c50cd5de80abfa28596806fd.png" style="width:396px;display:block;margin:0 auto" />