一、所需资料
钉钉账号
需要企业管理员权限的钉钉账号
已完成OpenClaw部署
确保OpenClaw已在你的服务器上运行
二、OpenClaw接入钉钉教程
第一步：创建钉钉应用和机器人
- 登录 钉钉开放平台
- 进入"应用开发" → "企业内部开发" → "创建应用"
- 填写应用名称、描述、图标
- 添加"机器人"能力
- 配置机器人：设置机器人名称、描述、头像
- 发布应用
第二步：获取Client ID和Client Secret
- 进入应用的"凭证与基础信息"页面
- 复制 Client ID（即AppKey）
- 复制 Client Secret（即AppSecret）
💡 重要提示
Client ID和Client Secret是配置OpenClaw的关键凭证，请妥善保管。
第三步：为OpenClaw配置模型和通道
bash
# 配置模型API Key
openclaw config set model.apiKey your_api_key
# 添加钉钉通道
openclaw channel add dingtalk \
--client-id YOUR_CLIENT_ID \
--client-secret YOUR_CLIENT_SECRET三、与钉钉机器人互动
私聊场景
搜索应用名称，添加为联系人后即可开始对话。
群聊场景
- 进入群设置
- 选择"机器人"
- 点击"添加机器人"
- 选择你创建的应用机器人
- @机器人即可开始对话
单聊模式
搜索应用名称，添加后一对一对话
群聊模式
群设置→机器人→添加机器人，@机器人对话
五、支持的消息类型
| 方向 | 类型 | 说明 |
|---|---|---|
| 接收 | 文本 | 普通文字消息 |
| 语音 | 语音消息，可转文字处理 | |
| 图片 | 图片消息，支持AI分析 | |
| 文件 | 文档、表格等文件 | |
| 回复 | 文本 | 普通文字回复 |
| 图片 | 图片回复 | |
| 文件 | 文档回复 | |
| Markdown | 富文本格式回复 | |
| 历史引用 | 引用历史消息回复 | |
| 主动 | 主动消息 | 机器人主动推送消息 |
💡 提示
钉钉支持丰富的消息卡片格式，可以实现更美观的交互界面。