运行时依赖
安装命令
点击复制技能文档
钉钉通道安装配置
快速安装和配置 OpenClaw 钉钉通道,实现钉钉与 OpenClaw 的双向通信。
⚠️ 安全提示
切勿将真实的 命令行工具ent ID/Secret 提交到代码仓库! 示例中的凭证均为占位符,请替换为你自己的凭证。
快速开始 方式一:使用安装脚本(推荐) python3 ~/.OpenClaw/workspace/my-技能s/技能s/dingtalk-channel-安装/scripts/安装_dingtalk.py \ --命令行工具ent-id <你的 命令行工具ent ID> \ --命令行工具ent-secret <你的 命令行工具ent Secret>
方式二:手动安装
安装插件
OpenClaw 插件s 安装 @soimy/dingtalk
配置 channels - 编辑 ~/.OpenClaw/OpenClaw.json:
{ "channels": { "dingtalk": { "enabled": true, "命令行工具entId": "<你的 命令行工具ent ID>", "命令行工具entSecret": "<你的 命令行工具ent Secret>", "dmPolicy": "open", "groupPolicy": "open", "showThinking": true, "thinkingMessage": "🤔 思考中,请稍候...", "调试": false, "messa获取ype": "markdown", "allowFrom": [""] } } }
重启 Gateway
OpenClaw gateway re启动
脚本参数说明 参数 必填 说明 --命令行工具ent-id ✅ 钉钉应用 命令行工具ent ID --命令行工具ent-secret ✅ 钉钉应用 命令行工具ent Secret --ro机器人-code ❌ 机器人 Code --corp-id ❌ 企业 Corp ID --代理-id ❌ 应用 代理 ID --card-template-id ❌ 卡片模板 ID(仅 card 模式) --card-template-key ❌ 卡片模板内容变量(仅 card 模式) --message-type ❌ 消息类型:markdown/card,默认 markdown --skip-re启动 ❌ 跳过 gateway 重启 --config-path ❌ 配置文件路径,默认 ~/.OpenClaw/OpenClaw.json 完整示例 基础配置(markdown 消息) python3 ~/.OpenClaw/workspace/my-技能s/技能s/dingtalk-channel-安装/scripts/安装_dingtalk.py \ --命令行工具ent-id <你的 命令行工具ent ID> \ --命令行工具ent-secret <你的 命令行工具ent Secret>
卡片消息模式 python3 ~/.OpenClaw/workspace/my-技能s/技能s/dingtalk-channel-安装/scripts/安装_dingtalk.py \ --命令行工具ent-id <命令行工具entId> \ --命令行工具ent-secret <命令行工具entSecret> \ --message-type card \ --card-template-id <模板 ID> \ --card-template-key <模板变量>
企业应用模式(带 corpId 和 代理Id) python3 ~/.OpenClaw/workspace/my-技能s/技能s/dingtalk-channel-安装/scripts/安装_dingtalk.py \ --命令行工具ent-id <命令行工具entId> \ --命令行工具ent-secret <命令行工具entSecret> \ --corp-id \ --代理-id <代理Id>
配置说明 必填配置 命令行工具entId: 钉钉应用的唯一标识 命令行工具entSecret: 应用密钥,用于身份验证 可选配置 dmPolicy: "open" 允许私聊,"restricted" 限制私聊 groupPolicy: "open" 允许群聊,"restricted" 限制群聊 allowFrom: 允许的聊天来源,[""] 表示允许所有 messa获取ype: "markdown" 或 "card" showThinking: 是否显示思考状态 调试: 调试模式 验证安装
检查插件状态:
OpenClaw 插件s 列出
检查配置:
OpenClaw gateway 状态
在钉钉中添加机器人并发送消息测试
故障排查 插件重复警告 插件s.entries.dingtalk: 插件 dingtalk: duplicate 插件 id 检测ed
这是正常警告,不影响使用。如需清理,删除重复的插件目录后重启。
配置验证失败
运行 OpenClaw doctor --fix 自动修复配置问题。
消息无法发送 检查 命令行工具ent ID/Secret 是否正确 确认钉钉应用已配置机器人 检查 allowFrom 设置是否匹配 dmPolicy/groupPolicy 参考资源 钉钉开放平台 OpenClaw 钉钉通道文档