Skillppx logo

DingTalk Channel Install

一键安装并配置 OpenClaw 钉钉通信通道，支持私聊与群聊。

已扫描
适合谁
使用 OpenClaw 的企业开发者、需要钉钉自动化通知的团队管理员
不适合谁
无钉钉企业账号的个人用户、不熟悉命令行操作的新手
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @k55k32/dingtalk-channel-install
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

钉钉通道安装配置

快速安装和配置 OpenClaw 钉钉通道，实现钉钉与 OpenClaw 的双向通信。

⚠️ 安全提示

切勿将真实的 Client ID/Secret 提交到代码仓库！ 示例中的凭证均为占位符，请替换为你自己的凭证。

快速开始

方式一：使用安装脚本（推荐）

python3 ~/.openclaw/workspace/my-skills/skills/dingtalk-channel-install/scripts/install_dingtalk.py \
  --client-id <你的 Client ID> \
  --client-secret <你的 Client Secret>

方式二：手动安装

  1. 安装插件
   openclaw plugins install @soimy/dingtalk
  1. 配置 channels - 编辑 ~/.openclaw/openclaw.json：
   {
     "channels": {
       "dingtalk": {
         "enabled": true,
         "clientId": "<你的 Client ID>",
         "clientSecret": "<你的 Client Secret>",
         "dmPolicy": "open",
         "groupPolicy": "open",
         "showThinking": true,
         "thinkingMessage": "🤔 思考中，请稍候...",
         "debug": false,
         "messageType": "markdown",
         "allowFrom": ["*"]
       }
     }
   }
  1. 重启 Gateway
   openclaw gateway restart

脚本参数说明

参数必填说明
--client-id✅钉钉应用 Client ID
--client-secret✅钉钉应用 Client Secret
--robot-code❌机器人 Code
--corp-id❌企业 Corp ID
--agent-id❌应用 Agent ID
--card-template-id❌卡片模板 ID（仅 card 模式）
--card-template-key❌卡片模板内容变量（仅 card 模式）
--message-type❌消息类型：markdown/card，默认 markdown
--skip-restart❌跳过 gateway 重启
--config-path❌配置文件路径，默认 ~/.openclaw/openclaw.json

完整示例

基础配置（markdown 消息）

python3 ~/.openclaw/workspace/my-skills/skills/dingtalk-channel-install/scripts/install_dingtalk.py \
  --client-id <你的 Client ID> \
  --client-secret <你的 Client Secret>

卡片消息模式

python3 ~/.openclaw/workspace/my-skills/skills/dingtalk-channel-install/scripts/install_dingtalk.py \
  --client-id <clientId> \
  --client-secret <clientSecret> \
  --message-type card \
  --card-template-id <模板 ID> \
  --card-template-key <模板变量>

企业应用模式（带 corpId 和 agentId）

python3 ~/.openclaw/workspace/my-skills/skills/dingtalk-channel-install/scripts/install_dingtalk.py \
  --client-id <clientId> \
  --client-secret <clientSecret> \
  --corp-id <corpId> \
  --agent-id <agentId>

配置说明

必填配置

  • clientId: 钉钉应用的唯一标识
  • clientSecret: 应用密钥，用于身份验证

可选配置

  • dmPolicy: "open" 允许私聊，"restricted" 限制私聊
  • groupPolicy: "open" 允许群聊，"restricted" 限制群聊
  • allowFrom: 允许的聊天来源，["*"] 表示允许所有
  • messageType: "markdown" 或 "card"
  • showThinking: 是否显示思考状态
  • debug: 调试模式

验证安装

  1. 检查插件状态：
   openclaw plugins list
  1. 检查配置：
   openclaw gateway status
  1. 在钉钉中添加机器人并发送消息测试

故障排查

插件重复警告

plugins.entries.dingtalk: plugin dingtalk: duplicate plugin id detected

这是正常警告，不影响使用。如需清理，删除重复的插件目录后重启。

配置验证失败

运行 openclaw doctor --fix 自动修复配置问题。

消息无法发送

  1. 检查 Client ID/Secret 是否正确
  2. 确认钉钉应用已配置机器人
  3. 检查 allowFrom 设置是否匹配 dmPolicy/groupPolicy

参考资源

  • [钉钉开放平台](https://open.dingtalk.com/)
  • [OpenClaw 钉钉通道文档](https://github.com/soimy/openclaw-channel-dingtalk)
K
@k55k32

已收录 1 个 Skill

相关推荐