钉钉通道安装配置

快速安装和配置 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>

方式二：手动安装

安装插件

openclaw plugins install @soimy/dingtalk

配置 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": ["*"]
    }
  }
}

重启 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: 调试模式

验证安装

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

故障排查

插件重复警告

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

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

配置验证失败

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

消息无法发送

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

DingTalk Channel Install